API ReferenceMCP

Create a new custom MCP server with multiple appsv3.1

POST
/api/v3.1/mcp/servers/custom

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.

Authorization

ApiKeyAuth
x-api-key<token>

Project API key authentication

In: header

Request Body

application/json

namestringRequired

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

auth_config_idsarray of string

ID references to existing authentication configurations

toolkitsarray of string

List of application/toolkit identifiers to enable for this server

allowed_toolsarray of string

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

custom_toolsarray of string

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

managed_auth_via_composioboolean

Whether to manage authentication via Composio

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v3.1/mcp/servers/custom" \  -H "Content-Type: application/json" \  -d '{    "name": "Development Integration Server",    "toolkits": [      "github",      "jira"    ]  }'
{  "id": "550e8400-e29b-41d4-a716-446655440000",  "name": "Multi-App Integration Server",  "auth_config_ids": [    "ac_1a2b3c4d5e6f",    "ac_7g8h9i0j1k2l"  ],  "allowed_tools": [    "GITHUB_CREATE_AN_ISSUE",    "JIRA_GET_ISSUE",    "SLACK_SEND_MESSAGE",    "GMAIL_SEND_EMAIL"  ],  "mcp_url": "https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john",  "commands": {    "cursor": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john\" --client cursor",    "claude": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john\" --client claude",    "windsurf": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"  }}
Edit this page on GitHub