API ReferenceMCP

List MCP servers for a specific appv3.1

GET
/api/v3.1/mcp/app/{appKey}

Retrieves a paginated list of Model Control Protocol (MCP) servers that are configured for a specific application or toolkit. This endpoint allows you to find all MCP server instances that have access to a particular application, such as GitHub, Slack, or Jira.

Authorization

ApiKeyAuth
x-api-key<token>

Project API key authentication

In: header

Path Parameters

appKeystringRequired

The key of the app to find MCP servers for

Query Parameters

namestring

Filter MCP servers by name (case-insensitive partial match)

toolkitsstring

Comma-separated list of toolkit slugs to filter servers by

auth_config_idsstring

Comma-separated list of auth config IDs to filter servers by

order_byenum

Field to order results by

Default: "updated_at"
Possible values:
created_atupdated_at
order_directionenum

Direction of ordering

Default: "desc"
Possible values:
ascdesc
page_nonullable number

Page number for pagination (1-based)

Default: 1
limitnullable number

Number of items per page (default: 10)

Default: 10

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v3.1/mcp/app/github"
{  "items": [    {      "id": "550e8400-e29b-41d4-a716-446655440000",      "name": "GitHub Integration Server",      "auth_config_ids": [        "ac_1a2b3c4d5e6f",        "ac_7g8h9i0j1k2l"      ],      "allowed_tools": [        "GITHUB_CREATE_AN_ISSUE",        "GITHUB_GET_A_REPOSITORY"      ],      "mcp_url": "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john",      "commands": {        "cursor": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client cursor",        "claude": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client claude",        "windsurf": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"      },      "toolkits": [        "github",        "jira",        "slack"      ],      "toolkit_icons": {        "github": "https://assets.composio.dev/logos/github.png",        "jira": "https://assets.composio.dev/logos/jira.png",        "slack": "https://assets.composio.dev/logos/slack.png"      },      "updated_at": "2023-06-15T14:30:00.000Z",      "created_at": "2023-06-10T09:15:00.000Z",      "server_instance_count": 5,      "managed_auth_via_composio": true    }  ],  "total_pages": 5,  "current_page": 1}
Edit this page on GitHub