Skip to main content
POST
Register an MCP server for an agent

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Path Parameters

agentId
string
required

Body

application/json
name
string
required

Human-readable label, unique per agent.

Required string length: 1 - 120
server_url
string
required

HTTPS URL of the MCP server (SSE transport).

Maximum string length: 2048
server_type
enum<string>
required

Transport type; only http_sse is supported.

Available options:
http_sse
auth_credentials
string

Optional static bearer token / API key, stored encrypted. Mutually exclusive with oauth2.

Maximum string length: 8192
tool_allowlist
string[]

Optional allowlist of tool names to expose. Absent = expose all; [] = expose none.

metadata
object

Optional free-form metadata.

enabled
boolean

Whether the server is active. Defaults to true.

Response

201 - application/json

The MCP server was registered.

data
object
meta
object