API Referencev3Mcp

Create a new MCP server

Creates a new Model Control Protocol (MCP) server instance for the authenticated project. An MCP server provides a connection point for AI assistants to access your applications and services. The server is configured with specific authentication and tool permissions that determine what actions the connected assistants can perform.

Headers

x-api-keystringRequired

Request

This endpoint expects an object.
namestringRequiredformat: "^[a-zA-Z0-9-]+$">=4 characters<=25 characters

Human-readable name to identify this MCP server instance (4-25 characters, alphanumeric and hyphens only)

auth_config_idstringOptional

ID reference to an existing authentication configuration

allowed_toolslist of stringsOptional

List of tool slugs that should be allowed for this server. If not provided, all available tools for the authentication configuration will be enabled.

ttlenumOptional

Time-to-live duration for this MCP server

Allowed values:

Response

MCP server created successfully. Returns the complete server configuration including connection details and command instructions.

idstring

UUID of the MCP server instance

namestring

User-defined descriptive name for this MCP server

auth_config_idstring

ID reference to the auth configuration used by this server

allowed_toolslist of strings

Array of tool slugs that this MCP server is allowed to use

mcp_urlstring

URL endpoint for establishing SSE connection to this MCP server

commandsobject

Set of command line instructions for connecting various clients to this MCP server

updated_atstring

Date and time when this server configuration was last modified

created_atstring

Date and time when this server was initially created