---
title: "Get a Context MCP connection"
method: GET
path: "/api/v1/context-mcps/{id}"
tags: ["contextMcp"]
---

# Get a Context MCP connection

`GET /api/v1/context-mcps/{id}`

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Response `200`

The connection.

- ContextMCPGetContextMcpResponse200
  - `contextMcp` ContextMcp
    - `id` string
    - `name` string
    - `url` string, uri — The MCP server URL.
    - `authMode` 'none' | 'static' | 'oauth' — How the server authenticates, detected on connect. `none`: unauthenticated. `static`: fixed headers you supplied. `oauth`: OAuth 2.1, with tokens managed by Dial.
    - `status` 'pending_auth' | 'connected' | 'error' — `pending_auth`: awaiting OAuth consent. `connected`: tools are wired to the agent. `error`: connection or token refresh failed (see `lastError`).
    - `toolCount` integer — Number of MCP tools wired into the agent.
    - `timeoutMs` integer, nullable — Connection timeout in ms; null uses the default (120000).
    - `headersMasked` object — Extra static request headers, with values masked. The OAuth-managed `Authorization` header is never returned.
    - `queryParams` object — Query parameters appended to the connection URL, with values masked.
    - `lastError` string, nullable
    - `createdAt` string, date-time

## Other responses

- `401` — Missing or invalid API key.
- `404` — The requested resource was not found on this account.

---

[API](https://skmtc.net/getdial/apis/rest-api.md) · [All operations](https://skmtc.net/getdial/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getdial/rest-api/versions/cfa621230237/schema)