---
title: "List MCP servers for a specific app"
method: GET
path: "/api/v3.1/mcp/app/{appKey}"
tags: ["MCP", "Servers", "Applications"]
---

# List MCP servers for a specific app

`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.

## Path parameters

- `appKey` string, required — Toolkit or application slug identifier to filter MCP servers by

## Query parameters

- `name` string — Name substring to filter servers by
- `toolkits` string
- `auth_config_ids` string
- `order_by` 'created_at' | 'updated_at' — Field to use for ordering the results
- `order_direction` 'asc' | 'desc' — Sort direction (ascending or descending)
- `page_no` number, nullable — Page number to retrieve
- `limit` number, nullable — Number of servers to return per page

## Response `200`

Successfully retrieved MCP servers for the specified application. Returns a paginated list of server configurations including connection details and command instructions.

- object — Paginated response containing MCP servers
  - `items` object[], required — Array of MCP server configurations
    - `id` string, required — UUID of the MCP server instance
    - `name` string, required — User-defined descriptive name for this MCP server
    - `auth_config_ids` string[], required — ID references to the auth configurations used by this server
    - `allowed_tools` string[], required — Array of tool slugs that this MCP server is allowed to use
    - `mcp_url` string, required — [DEPRECATED] Please use the URL with user_id or connected_account_id query param
    - `toolkits` string[], required — Array of toolkit slugs that this MCP server is allowed to use
    - `toolkit_icons` object, required — Object mapping each toolkit slug to its icon/logo URL for display purposes
    - `commands` object, required — Set of command line instructions for connecting various clients to this MCP server
      - `cursor` string, required — Command line instruction for Cursor client setup
      - `claude` string, required — Command line instruction for Claude client setup
      - `windsurf` string, required — Command line instruction for Windsurf client setup
    - `updated_at` string, required — Date and time when this server configuration was last modified
    - `created_at` string, required — Date and time when this server was initially created
    - `server_instance_count` number, required — Total count of active user instances connected to this server
    - `managed_auth_via_composio` boolean, required — Whether the MCP server is managed by Composio
  - `total_pages` number, required — Total number of pages in the paginated response
  - `current_page` number, required — Current page number being returned

## Other responses

- `400` — Bad request. The query parameters may be invalid or in an incorrect format.
- `401` — Unauthorized. Authentication is required or the provided credentials are invalid.
- `403` — Forbidden. The authenticated user does not have permission to view MCP servers for this application.
- `404` — Application not found. No application with the specified key exists.
- `500` — Internal server error. An unexpected error occurred while processing the request.

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/revisions/4239836857f8/schema)