Skip to main content
PUT
cURL

Authorizations

Authorization
string
header
required

A personal API key or an OAuth 2.0 access token. Personal API keys also require the x-auth-key header with your user ID.

Path Parameters

agent_id
string
required

ID of the agent.

server_id
string
required

ID of the MCP server from the caller's catalog.

Body

application/json

Free-form connector configuration. Identity keys are catalog-derived and ignored.

Response

The attached (or updated) MCP server.

agent_id
string
Example:

"abc123DEFghiJKL"

mcp_server
object

The resulting MCP server tool config, with secrets and server URL redacted.

created
boolean

true if the server was newly attached; false if an existing attachment was updated.

Example:

true

auth_status
string | null

Catalog authentication status for the server (e.g. whether OAuth has been completed).

Example:

"authenticated"