MCP server
Model Context Protocol server for IDEs and agents (VS Code, Cursor, Claude, Windsurf): `POST /mcp` speaks JSON-RPC with tools to route, quote, recommend, explain and ask; `GET /mcp` describes it.
API version 1.0.0
Model Context Protocol server for IDEs and agents (VS Code, Cursor, Claude, Windsurf): `POST /mcp` speaks JSON-RPC with tools to route, quote, recommend, explain and ask; `GET /mcp` describes it. Authenticate like the REST API.
get/mcp
Mcp Info
What the MCP server offers and how to connect (no key needed to read this).
No authentication.
Responses
| 200 | Successful Response |
curl -s "$OSR_URL/mcp"post/mcp
Mcp Endpoint
JSON-RPC 2.0 messages (single or batch) per the MCP specification.
Tools: `route, estimate, recommend, explain, list_targets, feedback,
ask (plans tier) and marketplace_search / marketplace_get. Every routed call is
metered against the workspace like /api/v1/route; notifications return 202`.
Requires an API key.
Responses
| 200 | Successful Response |
| 422 | Validation ErrorHTTPValidationError |
| 401 | Missing, invalid or revoked API key |
curl -s -X POST "$OSR_URL/mcp" \
-H "Authorization: Bearer $OSR_API_KEY"