Skip to navigation

The expert as an MCP server (Streamable HTTP)

Point Claude Code, Cursor or any Model Context Protocol client here with your API key as the bearer token. Stateless: every POST is a complete JSON-RPC exchange (initialize, tools/list, tools/call); the reply is JSON or a server-sent event stream as the client asks. Tools: ask_<expert> (chat:write), search_knowledge (knowledge:read), list_recent_conversations and get_conversation (conversations:read); a tool the key lacks the scope for is not listed. GET answers 405 (no standalone stream); DELETE answers 405 (no sessions).

Needs the mcp:use scope. A key without it gets 403 insufficient_scope. Routes not in this reference cannot be called with a key at all (403 not_available_to_api_keys).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired
The expert id.

Request

This endpoint expects a map from strings to any.

Response

OK

Errors

401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error