# AgentLayer — Multi-Protocol API Gateway for AI Agents

> A free, self-discoverable API server that AI agents can find and use automatically.
> Compatible with MCP, A2A (Google), GPT Actions (OpenAI), and llms.txt standards.

## What Agents Can Do Here

- [stock_price](https://agent.sluban.store/api/gateway?service=stock): Get real-time stock price for any ticker symbol. Returns current price, daily change, and volume. — ✅ Free tier: 100 calls/month
- [weather_forecast](https://agent.sluban.store/api/gateway?service=weather): Get 7-day weather forecast for any city. Returns temperature, humidity, wind speed, and conditions. — ✅ Free tier: 200 calls/month
- [code_review](https://agent.sluban.store/api/gateway?service=code): Automated code review. Submit a code snippet and get security, performance, and style feedback. — ✅ Free tier: 50 calls/month
- [news_search](https://agent.sluban.store/api/gateway?service=news): Search recent news articles by keyword. Returns title, source, date, and summary. — ✅ Free tier: 500 calls/month

## Resource Templates (URI-based access)

- `stock://prices/{symbol}`: Access real-time stock price as a resource. Replace {symbol} with ticker.
- `weather://forecast/{city}`: Access 7-day weather forecast as a resource. Replace {city} with city name.
- `news://search/{query}`: Search news articles by keyword. Replace {query} with search term.

## How Agents Discover This Server

| Protocol | Endpoint | Description |
|----------|----------|-------------|
| MCP (Anthropic) | `https://agent.sluban.store/api/mcp` | JSON-RPC 2.0 — tools/list, tools/call, resources/read |
| A2A (Google) | `https://agent.sluban.store/.well-known/agent.json` | Agent Card auto-discovery |
| GPT Actions (OpenAI) | `https://agent.sluban.store/.well-known/ai-plugin.json` | OpenAI plugin manifest |
| llms.txt | `https://agent.sluban.store/llms.txt` | This file — Markdown for LLM consumption |
| OpenAPI 3.0 | `https://agent.sluban.store/openapi.json` | Machine-readable API specification |

## Authentication

Provide your Agent Key via:
- Header: `Authorization: Bearer al_agent_YOUR_KEY`
- Query: `?key=al_agent_YOUR_KEY`

Free tier: Each tool has its own monthly free quota (see above).

## Rate Limits

- Stock: 100 free/month
- Weather: 200 free/month
- Code Review: 50 free/month
- News: 500 free/month

Exceeding limits: Pay-per-call pricing at \$0.0005–\$0.01/call.

## Contact & Status

- Status: https://agent.sluban.store/api/mcp (GET)
- OpenAPI Spec: https://agent.sluban.store/openapi.json