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

Request parameters for creating a new MCP server with specific authentication configuration

name
string
required

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

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

"Production GitHub Integration"

auth_config_ids
string[]
required

ID references to existing authentication configurations

Example:
no_auth_apps
string[]

List of NO_AUTH apps to enable for this MCP server

Example:
allowed_tools
string[]

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

Example:
managed_auth_via_composio
boolean

Whether the MCP server is managed by Composio

Response

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

MCP server configuration and connection details

id
string
required

UUID of the MCP server instance

Example:

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

name
string
required

User-defined descriptive name for this MCP server

Example:

"GitHub Integration Server"

auth_config_ids
string[]
required

ID references to the auth configurations used by this server

Example:
allowed_tools
string[]
required

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

Example:
mcp_url
string
required
deprecated

[DEPRECATED] Please use the URL with user_id or connected_account_id query param

Example:

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

toolkits
string[]
required

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

Example:
toolkit_icons
object
required

Object mapping each toolkit slug to its icon/logo URL for display purposes

Example:
commands
object
required
deprecated

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

updated_at
string
required

Date and time when this server configuration was last modified

Example:

"2023-06-15T14:30:00.000Z"

created_at
string
required

Date and time when this server was initially created

Example:

"2023-06-10T09:15:00.000Z"

server_instance_count
number
required

Total count of active user instances connected to this server

Example:

5

managed_auth_via_composio
boolean
required

Whether the MCP server is managed by Composio

Example:

true