API ReferenceMCP

Generate MCP URL with custom parametersv3.1Legacy

Deprecated

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

Generates a Model Control Protocol (MCP) URL for an existing server with custom query parameters. The URL includes user-specific parameters and configuration flags that control the behavior of the MCP connection.

Authorization

ApiKeyAuth
x-api-key<token>

Project API key authentication

In: header

Request Body

application/json

mcp_server_idstringRequired

Unique identifier of the MCP server to generate URL for

managed_auth_by_composiobooleanDeprecated

Flag indicating if Composio manages authentication. When true, the generated URLs include the include_composio_helper_actions query parameter. DEPRECATED: The include_composio_helper_actions query parameter will be removed in a future version. Switch to Composio Sessions (POST /api/v3/tool_router/session), whose MCP URL includes connection-management tools.

Default: false
user_idsarray of string

List of user identifiers for whom the URL is generated

connected_account_idsarray of string

List of connected account identifiers

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v3.1/mcp/servers/generate" \  -H "Content-Type: application/json" \  -d '{    "mcp_server_id": "550e8400-e29b-41d4-a716-446655440000",    "user_ids": [      "user_123456"    ],    "connected_account_ids": [      "ca_1a2b3c4d5e6f",      "ca_7g8h9i0j1k2l"    ]  }'
{  "mcp_url": "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000",  "connected_account_urls": [    "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_id=ca_1a2b3c4d5e6f",    "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_id=ca_7g8h9i0j1k2l"  ],  "user_ids_url": [    "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&user_id=user_123456",    "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&user_id=user_789012"  ]}
Edit this page on GitHub