OUouterport
Agent MCP Servers

Connect an MCP server

Changed on

Register a Model Context Protocol server reachable over streamable HTTP. Attach it to a persona to put its tools in that persona's toolset.

post/api/v0/agent/mcp-servers

Request

Request body

namestring required

Display name. Also the prefix its tools are exposed under, so two servers with the same name cannot both contribute a tool.

urlstring required

The server's streamable-HTTP endpoint.

headersobject

HTTP headers sent verbatim on every request to the server, e.g. an Authorization header. Write-only: never returned on read.

Response

Successful Response

idstring uuid required

The ID of the MCP server.

namestring required

The display name of the MCP server.

urlstring required

The server's streamable-HTTP endpoint.

header_namesstring[]

Names of the configured HTTP headers. Values are never returned.

created_atstring date-time required

When the server was connected.

updated_atstring date-time required

When the server was last updated.

Changes