---
title: "Get MCP server details by ID"
method: GET
path: "/api/v3.1/mcp/{id}"
tags: ["MCP", "Servers"]
---

# Get MCP server details by ID

`GET /api/v3.1/mcp/{id}`

Retrieves detailed configuration information for a specific Model Control Protocol (MCP) server. The returned data includes connection details, associated applications, enabled tools, and authentication configuration.

## Path parameters

- `id` string, required — Unique identifier of the MCP server to retrieve, update, or delete

## Response `200`

Successfully retrieved MCP server. Returns the complete server configuration including connection details, authentication settings, and available tools.

- object — MCP server configuration and connection details
  - `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
  - `deleted` boolean, required — Whether the MCP server is deleted

## Other responses

- `400` — Bad request. The server ID parameter 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 this MCP server.
- `404` — MCP server not found. No server with the specified ID exists or it has been deleted.
- `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)