---
title: "Retrieve an MCP server"
method: GET
path: "/mcp/servers/{server_id}"
tags: ["MCP"]
---

# Retrieve an MCP server

`GET /mcp/servers/{server_id}`

Return a single MCP server. The response populates `allowed_tool_call_ids` with the tool call IDs the caller is permitted to invoke on this server.

## Path parameters

- `server_id` string, required

## Query parameters

- `team_id` string

## Response `200`

The requested MCP server.

- object
  - `server` object
    - `server_id` string, required
    - `name` string, nullable
    - `type` string, required — One of `gumcp_server`, `gumstack_server`, or `mcp_server`.
    - `status` string, required
    - `icon_url` string, nullable
    - `description` string, nullable
    - `gumloop_auth_url` string, required
    - `mcp_url` string, nullable
    - `tool_count` integer, nullable
    - `allowed_tool_call_ids` string[], nullable — Tool call IDs the caller is permitted to invoke on this server, after RBAC and policy checks.

## Other responses

- `401` — Unauthorized — missing or invalid API key.
- `403` — Forbidden — the caller does not have agent access on the requested team.
- `404` — MCP server not found.
- `500` — Internal server error.

---

[API](https://skmtc.dev/gumloop/apis/public-api.md) · [All operations](https://skmtc.dev/gumloop/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gumloop/public-api/revisions/115f2d6ce387/schema)