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 (DCR done, waiting on the user's consent/callback);
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"

