Create a new MCP server | Composio Docs

Creates a new Model Control Protocol (MCP) server instance for the authenticated project. An MCP server provides a connection point for AI assistants to access your applications and services. The server is configured with specific authentication and tool permissions that determine what actions the connected assistants can perform.

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 MCP server instance (4-30 characters, alphanumeric, spaces, and hyphens only)

auth_config_idslist of stringsOptional

ID references to existing authentication configurations

allowed_toolslist of stringsOptional

List of tool slugs that should be allowed for this server. If not provided, all available tools for the authentication configuration will be enabled.

ttlenumOptional

Time-to-live duration for this MCP server

Allowed values:

managed_auth_via_composiobooleanOptional

Whether the MCP server is managed by Composio

Response

MCP server created successfully. Returns the complete server configuration including connection details and command instructions.

idstring

UUID of the MCP server instance

namestring

User-defined descriptive name for this MCP server

auth_config_idslist of strings

ID references to the auth configurations used by this server

allowed_toolslist of strings

Array of tool slugs that this MCP server is allowed to use

mcp_urlstring

URL endpoint for establishing SSE connection to this MCP server

toolkitslist of strings

Array of toolkit slugs that this MCP server is allowed to use

commandsobject

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

updated_atstring

Date and time when this server configuration was last modified

created_atstring

Date and time when this server was initially created

managed_auth_via_composioboolean

Whether the MCP server is managed by Composio

1	curl -X POST https://backend.composio.dev/api/v3/mcp/servers \
2	-H "x-api-key: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"name": "GitHub Integration Server",
6	"auth_config_ids": [
7	"auth_cfg_abc123def456"
8	]
9	}'

1	{
2	"id": "550e8400-e29b-41d4-a716-446655440000",
3	"name": "GitHub Integration Server",
4	"auth_config_ids": [
5	"auth_cfg_abc123def456",
6	"auth_cfg_xyz789"
7	],
8	"allowed_tools": [
9	"github-issues",
10	"github-repos",
11	"github-pull-requests"
12	],
13	"mcp_url": "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?transport=sse",
14	"toolkits": [
15	"github",
16	"jira",
17	"slack"
18	],
19	"commands": {
20	"cursor": "npx @composio/mcp@latest setup \"https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000\" --client cursor",
21	"claude": "npx @composio/mcp@latest setup \"https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000\" --client claude",
22	"windsurf": "npx @composio/mcp@latest setup \"https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000\" --client windsurf"
23	},
24	"updated_at": "2023-06-15T14:30:00.000Z",
25	"created_at": "2023-06-10T09:15:00.000Z",
26	"managed_auth_via_composio": true
27	}

Headers

Request

Response

Errors