Skip to main content
GET
Get one of the calling user's MCP connections

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

The connection id returned by POST /mcp-connections.

Response

The connection's status view.

Status view of one connection. Deliberately credential-free — the registered client secret and the encrypted access/refresh tokens are never returned.

connection_id
string<uuid>
required
Example:

"b3f1c2a4-5d6e-47f8-9a0b-1c2d3e4f5a6b"

server_url
string<uri>
required

The external MCP server this connection targets.

Example:

"https://huggingface.co/mcp"

alias
string
required
Example:

"huggingface"

authorization_server
string<uri>
required

The OAuth issuer discovered for the server.

Example:

"https://huggingface.co"

status
enum<string>
required

Lifecycle. pending after creation (DCR done, waiting on the user's consent/callback); connected once the token exchange succeeds and tools/list validates; error for a failed connection.

Available options:
pending,
connected,
error
Example:

"connected"

created_at
string<date-time>
required
Example:

"2026-07-12T17:00:00Z"

updated_at
string<date-time>
required
Example:

"2026-07-12T17:02:11Z"

expires_at
string<date-time> | null

When the current access token expires, if the server issued an expiry. The platform refreshes it automatically before use when a refresh token is available.

Example:

"2026-07-12T18:30:00Z"