MCP Endpoints
Endpoints for adding, logging in to and managing MCP servers and their tools.
| Method | Path | Description |
|---|---|---|
GET POST |
/v1/mcp |
local — list / add MCP servers. The GET also returns oauth: {name: bool} for the HTTP servers, saying which ones already hold a token |
POST |
/v1/mcp/remove |
local — remove an MCP server |
GET |
/v1/mcp/status |
local — connection status per server |
POST |
/v1/mcp/reconnect |
local — reconnect all MCP clients and re-register tools |
GET |
/v1/mcp/oauth?name=X |
local — SSE OAuth login for one HTTP MCP server, mirroring the provider flow: emits {"url":...} for the browser, then {"done":true,"ok":...} (plus reconnect_error when the post-login reconnect fails). Times out after 10 minutes, or when the client disconnects |
POST |
/v1/mcp/oauth/callback |
local — {name, url}. Hands the redirect URL back when the browser cannot reach the daemon's loopback listener on localhost:17988; the code is parsed out of the URL's query. 400 if no login is waiting for that server |
POST |
/v1/mcp/oauth/client |
local — {name, client_id, client_secret?, redirect_uri?}. Stores a pre-registered OAuth client for servers that reject dynamic registration; redirect_uri defaults to http://localhost:17988/callback and must match the provider console exactly. Clears any existing token first |
DELETE |
/v1/mcp/oauth |
local — {name}. Clears both the stored token and the client registration for that server |