Register an MCP server for an agent
Register a Model Context Protocol (MCP) server so the agent can discover and call the tools it exposes. Supply a name, an https:// server_url, and server_type: http_sse, optionally with a static bearer credential or an OAuth2 grant (mutually exclusive) and a tool_allowlist that scopes which tools are exposed. The URL is SSRF-validated and any credentials are encrypted at rest. Requires an operator role (owner, admin, or developer).
Authorizations
Dashboard JWT token from Clerk
Path Parameters
Body
Human-readable label, unique per agent.
1 - 120HTTPS URL of the MCP server (SSE transport).
2048Transport type; only http_sse is supported.
http_sse Optional static bearer token / API key, stored encrypted. Mutually exclusive with oauth2.
8192Optional allowlist of tool names to expose. Absent = expose all; [] = expose none.
Optional free-form metadata.
Whether the server is active. Defaults to true.