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.

Authentication

x-api-keystring

API key authentication

Request

This endpoint expects an object.

namestringRequiredformat: "^[a-zA-Z0-9- ]+$"4-30 characters

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

auth_config_idslist of stringsOptional

ID references to existing authentication configurations

toolkitslist of stringsOptional

List of application/toolkit identifiers to enable for this server

allowed_toolslist of stringsOptional

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

custom_toolslist of stringsOptional

DEPRECATED: Use allowed_tools instead. 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 connection to this MCP server

commandsobject

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

1	import requests
2
3	url = "https://backend.composio.dev/api/v3/mcp/servers/custom"
4
5	payload = {
6	"name": "Complete Workflow Integration",
7	"toolkits": ["github", "jira", "slack"],
8	"custom_tools": ["internal-api-tool"]
9	}
10	headers = {
11	"x-api-key": "<apiKey>",
12	"Content-Type": "application/json"
13	}
14
15	response = requests.post(url, json=payload, headers=headers)
16
17	print(response.json())

1	{
2	"id": "550e8400-e29b-41d4-a716-446655440000",
3	"name": "Multi-App Integration Server",
4	"auth_config_ids": [
5	"auth_cfg_abc123def456",
6	"auth_cfg_xyz789"
7	],
8	"allowed_tools": [
9	"github-issues",
10	"jira-tickets",
11	"slack-messages",
12	"custom-api-tool"
13	],
14	"mcp_url": "https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john",
15	"commands": {
16	"cursor": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john\" --client cursor",
17	"claude": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john\" --client claude",
18	"windsurf": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8410-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"
19	}
20	}

Authentication

Request

Response

Errors