Sign in
MCP
Servers
URL Generation

Generate MCP URL with custom parameters

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.

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

Request body

mcp_server_idstring required

Unique identifier of the MCP server to generate URL for

managed_auth_by_composioboolean

Flag indicating if Composio manages authentication

user_idsstring[]

List of user identifiers for whom the URL is generated

connected_account_idsstring[]

List of connected account identifiers

Example request

{
  "mcp_server_id": "550e8400-e29b-41d4-a716-446655440000",
  "managed_auth_by_composio": true,
  "user_ids": [
    "user_123456",
    "user_789012"
  ],
  "connected_account_ids": [
    "ca_1a2b3c4d5e6f",
    "ca_7g8h9i0j1k2l",
    "ca_3m4n5o6p7q8r"
  ]
}

Response

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

mcp_urlstring required

Base MCP URL without any query parameters

connected_account_urlsstring[] required

List of URLs generated for each connected account ID

user_ids_urlstring[] required

List of URLs generated for each user ID

Example response

{
  "mcp_url": "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000",
  "connected_account_urls": [
    "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_id=ca_1a2b3c4d5e6f",
    "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&connected_account_id=ca_7g8h9i0j1k2l"
  ],
  "user_ids_url": [
    "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&user_id=user_123456",
    "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?include_composio_helper_actions=true&user_id=user_789012"
  ]
}

Changes

Changed in 2 of the 61 revisions of this API.3

  • 589a7d115a5e2See the full diff
    • ○

      the endpoint scheme security CookieAuth was removed from the API

      api-security-removed

    • ○

      the endpoint scheme security UserApiKeyAuth was removed from the API

      api-security-removed

  • 52c71f747c651See the full diff
    • ○

      endpoint added

      endpoint-added