---
title: "Sign-in status of every signed-in tool server"
method: GET
path: "/client/mcp/oauth/status"
tags: ["Tool gateway"]
---

# Sign-in status of every signed-in tool server

`GET /client/mcp/oauth/status`

## Request

- Base URL: `https://api.roar-ai.com`
- URL: `https://api.roar-ai.com/client/mcp/oauth/status`
- Auth: HTTP bearer

For each tool server that signs in: connected or needs signing in again, who signed in and when. No token is ever returned. Requires `mcp:read`.

## Response `200`

Sign-in status

- McpSignInStatusList
  - `data` McpSignInStatus[], required
    - `upstreamId` string, uuid, required
    - `state` 'not_signed_in' | 'connected' | 'needs_sign_in', required
    - `signedInBy` object, nullable, required: The person who signed in. Null once they are deleted
      - `id` string, required
      - `name` string, required
      - `email` string, required
    - `signedInByFormerMember` boolean, required: The person who signed in has left the organisation: sign in again as someone current
    - `signedInAt` string, date-time, nullable, required
    - `accountLabel` string, nullable, required: The vendor account the sign-in page REPORTED, when it named one. Unverified
    - `accountLabelVerified` false, required: Always false: `accountLabel` is not verified
    - `signInHost` string, nullable, required: The sign-in server’s host
    - `knownVendor` boolean, required: Whether the sign-in is a vendor Roar recognises, rather than a server’s own
    - `vendor` string, nullable, required: That vendor’s name, when `knownVendor`
    - `scopes` string[], required: The permissions granted
    - `problem` 'renewal_refused' | 'server_refused' | 'no_refresh_token' | 'app_removed' | 'unreadable' | 'null', nullable, required: Why it needs signing in again. Null unless `state` is `needs_sign_in`

## Other responses

- `403`: Key lacks mcp:read

---

[API](https://skmtc.dev/roar-ai/apis/roar-ai-api.md) · [All operations](https://skmtc.dev/roar-ai/apis/roar-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roar-ai/apis/roar-ai-api/revisions/37e4d0d5a7fe?raw)