---
title: "Get MCP Server Signals"
method: GET
path: "/v1/mcp-cp/{controlPlaneId}/signals"
tags: ["Signaling APIs"]
---

# Get MCP Server Signals

`GET /v1/mcp-cp/{controlPlaneId}/signals`

## Request

- Base URL: `https://global.api.konghq.com`
- URL: `https://global.api.konghq.com/v1/mcp-cp/{controlPlaneId}/signals`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

**Pre-release Endpoint**
This endpoint is currently in beta and is subject to change.

Client-initiated signals fetch with long-polling capabilities.
The client supplies `capabilities` as a deepObject query parameter:


  - Keys are capability names (e.g. `mcp`)
  - Values contain the capability request fields (`version`)

Example:


  GET /mcp-cp/{controlPlaneId}/signals?capabilities[mcp][version]=5

The CP responds with a JSON payload containing zero or more signals that the client should process.
If no signals are available, the CP responds with HTTP 304 Not Modified.

## Query parameters

- `capabilities` MCPCapabilitiesMap: Map of capability name -> capability request fields. Example: { "mcp": { "version": "v1", "offset": "5" } }
  - `mcp` MCPCapabilityRequest
    - `version` string, required: The version of the capability schema (e.g., v1).
    - `offset` string: The version of the control plane known by the client.

## Response `200`

The MCP server signals response.

- MCPServerSignals: The MCP server signals response.
  - `signals` MCPServerSignal[], required: A list of signals for the MCP server.
    - `type` 'mcp', required
    - `version` string, required: The current version of the MCP control plane.
    - `offset` string, required: The offset for the MCP signal.

## Other responses

- `304`: No signals available (client is up to date)
- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning
  - added `#/components/schemas/InvalidParameterMinimumTime, #/components/schemas/InvalidParameterMaximumTime` to the `invalid_parameters/items/` response property `oneOf` list for the response status `400`
  - added the new `key_invalid` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - added the new `unique` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2026-09-30** `de79e1192f11`: 2 info
  - api tag `Signaling APIs` added
  - api tag `MCP Servers` removed
- **2026-09-25** `68d43091b84d`: 2 warning
  - added the new `400.00` enum value to the `status` response property for the response status `400`
  - added the new `403.00` enum value to the `status` response property for the response status `403`
- **2026-09-18** `f324fb7610e4`: 2 breaking, 18 info
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `403`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `400`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `401`
  - …16 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v1/mcp-cp/:controlPlaneId/signals/get.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api-go-sdk/revisions/7aab863a6daa?raw)