Get one of the calling user's MCP connections
Returns a single connection’s status view. Credential-free — no client secret or tokens.
Scope: per-user, not per-company
Only resolves connections owned by the bearer token’s company_id and user_id. A connection
that exists but belongs to someone else returns 404, identical to a nonexistent id (so ids can’t be
probed across users).
Permission
agent_conversations resource with read verb.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
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.
"b3f1c2a4-5d6e-47f8-9a0b-1c2d3e4f5a6b"
The external MCP server this connection targets.
"https://huggingface.co/mcp"
"huggingface"
The OAuth issuer discovered for the server.
"https://huggingface.co"
Lifecycle. pending after creation, and while waiting on the user's consent and the
completion call; connected once the token exchange succeeds and tools/list validates;
error for a failed connection.
pending, connected, error "connected"
"2026-07-12T17:00:00Z"
"2026-07-12T17:02:11Z"
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.
"2026-07-12T18:30:00Z"

