# MCP server

Streamable HTTP (JSON-RPC 2.0) at `POST /mcp`; send `Accept: application/json, text/event-stream` for SSE framing. `initialize` returns `Mcp-Session-Id`. Auth: `Authorization: Bearer <key>`. Discovery and quote tools work without a key.

| Tool | Purpose | Arguments |
|---|---|---|
| `list_endpoints` | Endpoints with price, source, latency | `category`? |
| `search_endpoints` | Free-text search | `query`, `category`, `limit` |
| `get_endpoint` | Schemas, output fields, examples | `endpoint` |
| `quote_endpoint` | Validate input, exact cost, can this key afford it | `endpoint`, `input` |
| `run_endpoint` | Run and bill the wallet | `endpoint`, `input`; `fields`, `max_items`, `summary`, `max_cost_usd` |
| `get_request` | Status/result of an earlier request (free) | `request_id` |
| `get_balance` | Wallet balance (free) | — |
| `report_bug` | Wrong data or misleading error (free) | `summary`; `details`, `endpoint`, `request_id`, `contact` |
| `send_feedback` | Other feedback (free) | same as `report_bug` |

Claude Code: `claude mcp add --transport http site-audit https://audit.45-94-66-237.sslip.io/mcp --header "Authorization: Bearer $SITEAUDIT_API_KEY"`

Not in this build: OAuth for MCP clients, a stdio wrapper package, registry listing.
