Generate MCP URL with custom parameters

1 curl -X POST https://backend.composio.dev/api/v3/mcp/servers/generate \ 2 -H "x-api-key: <apiKey>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "mcp_server_id": "550e8400-e29b-41d4-a716-446655440000", 6 "user_ids": [ 7 "user_123456" 8 ], 9 "connected_account_ids": [ 10 "account_1", 11 "account_2" 12 ] 13 }'

1 { 2 "mcp_url": "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000", 3 "connected_account_urls": [ 4 "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_ids=account_1&user_id=user_123456,user_789012", 5 "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_ids=account_2&user_id=user_123456,user_789012" 6 ], 7 "user_ids_url": [ 8 "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_ids=account_1,account_2&user_id=user_123456", 9 "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_ids=account_1,account_2&user_id=user_789012" 10 ] 11 }

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.

Headers

x-api-keystringRequired

Request

This endpoint expects an object.

mcp_server_idstringRequired

Unique identifier of the MCP server to generate URL for

managed_auth_by_composiobooleanOptionalDefaults to false

Flag indicating if Composio manages authentication

user_idslist of stringsOptional

List of user identifiers for whom the URL is generated

connected_account_idslist of stringsOptional

List of connected account identifiers

Response

Successfully generated MCP URL. Returns the complete URL with all specified query parameters.

mcp_urlstring

Base MCP URL without any query parameters

connected_account_urlslist of strings

List of URLs generated for each connected account ID

user_ids_urllist of strings

List of URLs generated for each user ID

Headers

Request

Response

Errors