---
title: "Get the current OAuth connection status for an MCP server"
method: GET
path: "/api/mcp-oauth/{mcpServerId}/status"
tags: ["MCP OAuth"]
---

# Get the current OAuth connection status for an MCP server

`GET /api/mcp-oauth/{mcpServerId}/status`

## Path parameters

- `mcpServerId` string, required

## Query parameters

- `userId` string

## Response `200`

Token status (never includes the token value itself)

- object
  - `mcpServerId` string, required
  - `authMethod` 'static' | 'oauth' | 'auto', required
  - `connected` boolean, required
  - `token` object, nullable, required
    - `id` string, required
    - `status` 'connected' | 'expired' | 'error' | 'revoked', required
    - `tokenType` string, required
    - `expiresAt` string, nullable, required
    - `scope` string, nullable, required
    - `lastErrorMessage` string, nullable, required
    - `lastRefreshedAt` string, nullable, required
    - `authorizationServerIssuer` string, required
    - `resourceUrl` string, required
    - `clientSource` 'dcr' | 'manual' | 'preregistered', required
    - `hasRefreshToken` boolean, required
    - `createdAt` string, required
    - `updatedAt` string, required

## Other responses

- `404` — MCP server not found

---

[API](https://skmtc.net/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.net/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/versions/ef761849166b/schema)