v63

latestOpenAPI 3.0.0Proprietaryraw.githubusercontent.com2026-08-0110571.8 MB

MCP

Servers

Custom

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.

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

Request body

namestring required

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

auth_config_idsstring[]

ID references to existing authentication configurations

toolkitsstring[]

List of application/toolkit identifiers to enable for this server

allowed_toolsstring[]

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

custom_toolsstring[]

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

Example request

{
  "name": "Multi App Integration Server",
  "auth_config_ids": [
    "ac_1a2b3c4d5e6f",
    "ac_7g8h9i0j1k2l"
  ],
  "toolkits": [
    "github",
    "jira",
    "slack"
  ],
  "allowed_tools": [
    "GITHUB_CREATE_AN_ISSUE",
    "SLACK_SEND_MESSAGE"
  ],
  "custom_tools": [
    "GITHUB_CREATE_AN_ISSUE",
    "SLACK_SEND_MESSAGE"
  ]
}

Response

Custom MCP server created successfully. Returns the complete server configuration including connection details and command instructions for all specified applications.

idstring required

Unique identifier for the newly created custom MCP server

namestring required

Human-readable name of the custom MCP server

auth_config_idsstring[] required

ID references to the auth configurations used by this server

allowed_toolsstring[] required

List of tool identifiers that are enabled for this server

mcp_urlstring required

URL endpoint for establishing connection to this MCP server

Example response

{
  "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"
  }
}