Register a custom MCP server

POST 
/api/v1/mcp-servers/create

Registers an HTTP MCP server in the caller's project. A duplicate server ID fails with 409; use update to replace the record.

Configuration validation and the egress guard run before storage. Invalid configuration, a referenced secret absent from this project, or an attempt to create at the configured project limit (20 servers by default) returns 400. Concurrent creates can exceed this count-before-create limit. Secret existence is checked at write time so a missing credential is reported before the first tool call. Endpoint restrictions also apply when connecting; an HTTPS URL alone does not establish a safe destination.

Request

Responses

200

Server registered; the stored record is echoed back

Document ID: DOC-IN-tools-connections-servers-api-createCustomMcpServer. Section identities and revisions.

Section	Stable reference
Overview	DOC-IN-tools-connections-servers-api-createCustomMcpServer#overview
Request	DOC-IN-tools-connections-servers-api-createCustomMcpServer#request
Responses	DOC-IN-tools-connections-servers-api-createCustomMcpServer#responses