API ReferenceMCP

Create a new custom MCP server with multiple apps

Creates a new Model Control Protocol (MCP) server instance that can integrate with multiple applications or toolkits simultaneously. This endpoint allows you to create a server that can access tools from different applications, making it suitable for complex workflows that span multiple services.

Headers

x-api-keystringRequired

Request

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

Human-readable name to identify this custom MCP server (4-30 characters, alphanumeric, spaces, and hyphens only)

toolkitslist of stringsRequired

List of application/toolkit identifiers to enable for this server

auth_config_idslist of stringsOptional
ID references to existing authentication configurations
custom_toolslist of stringsOptional
Additional custom tool identifiers to enable that aren't part of standard toolkits
managed_auth_via_composiobooleanOptional
Whether to manage authentication via Composio

Response

Custom MCP server created successfully. Returns the complete server configuration including connection details and command instructions for all specified applications.
idstring
Unique identifier for the newly created custom MCP server
namestring

Human-readable name of the custom MCP server

auth_config_idslist of strings
ID references to the auth configurations used by this server
allowed_toolslist of strings
List of tool identifiers that are enabled for this server
mcp_urlstring

URL endpoint for establishing Server-Sent Events (SSE) connection to this MCP server

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

Errors