Skip to main content
POST

Authorizations

x-api-key
string
header
default:your-project-api-key
required

Your Composio project API key. Create or copy it from the Composio dashboard.

Body

application/json

Parameters for creating a new custom MCP server with multiple applications

name
string
required

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

Required string length: 4 - 30
Pattern: ^[a-zA-Z0-9- ]+$
Example:

"Multi App Integration Server"

auth_config_ids
string[]

ID references to existing authentication configurations

Example:
toolkits
string[]

List of application/toolkit identifiers to enable for this server

Example:
allowed_tools
string[]

Tool identifiers to enable that aren't part of standard toolkits

Example:
custom_tools
string[]

DEPRECATED: Use allowed_tools instead. Tool identifiers to enable that aren't part of standard toolkits

Example:
managed_auth_via_composio
boolean

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.

Response for a successfully created custom MCP server with multiple applications

id
string
required

Unique identifier for the newly created custom MCP server

Example:

"550e8400-e29b-41d4-a716-446655440000"

name
string
required

Human-readable name of the custom MCP server

Example:

"Multi-App Integration Server"

auth_config_ids
string[]
required

ID references to the auth configurations used by this server

Example:
allowed_tools
string[]
required

List of tool identifiers that are enabled for this server

Example:
mcp_url
string
required

URL endpoint for establishing connection to this MCP server

Example:

"https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john"

commands
object
required

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