---
title: "Get an MCP Proxy definition."
method: GET
path: "/tyk/mcps/{apiID}"
tags: ["MCP Proxies"]
---

# Get an MCP Proxy definition.

`GET /tyk/mcps/{apiID}`

Retrieve a single MCP Proxy definition by its ID. When `expand=true` is supplied for an internal REST-as-MCP proxy target, the response includes the full derived `x-tyk-mcp-server.primitives` catalogue with selected and unselected tools marked by `allow`. Normal reads return the stored definition exactly. `expand=true` has no effect for remote MCP proxy upstreams.

## Query parameters

- `expand` boolean

## Other responses

- `404` — MCP Proxy definition not found.

## Changes

- **2026-07-30** `4ae998d5545e` — 1 info
  - added the new optional `query` request parameter `expand`
- **2026-04-28** `6ed22d4396e1` — 1 info
  - endpoint added
- **2022-05-24** `111d8ca21864` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/tyktechnologies/apis/tyk-gateway-api/changes/tyk/mcps/:apiID/get.md)

---

[API](https://skmtc.dev/tyktechnologies/apis/tyk-gateway-api.md) · [All operations](https://skmtc.dev/tyktechnologies/apis/tyk-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tyktechnologies/tyk-gateway-api/revisions/900d0a33ae1d/schema)