---
title: "Read signed-in device consent context"
method: GET
path: "/credits/mcp/oauth/device/context"
tags: ["MCP"]
---

# Read signed-in device consent context

`GET /credits/mcp/oauth/device/context`

## Request

- Base URL: `https://api.paywithlocus.com/api`
- URL: `https://api.paywithlocus.com/api/credits/mcp/oauth/device/context`
- Auth: HTTP bearer

Returns the selected account, grantable scopes, connection capacity, resource, and expiry immediately before a human approves or denies the device. Requested scopes may be reduced to the member's effective authority.

## Query parameters

- `user_code` string, required: Case-insensitive device-code input. Locus ignores non-alphanumeric punctuation, rejects ambiguous characters, and normalizes the six significant characters to XXX-XXX.

## Headers

- `X-Locus-Tenant-Id` string, uuid

## Response `200`

Device consent context

- McpOAuthDeviceContextResponse
  - `success` unknown, required
  - `data` object, required
    - `userCode` string, required: Human-readable code that omits ambiguous characters. Display it exactly as returned.
    - `clientName` string, required
    - `clientId` string, required
    - `tenantName` string, required
    - `scopes` string[], required
    - `scopeReduced` boolean, required
    - `connectionCapacity` McpConnectionCapacity, required
      - `plan` 'free' | 'plus' | 'unlimited', required
      - `limit` integer, nullable, required: Null for an unlimited plan or enterprise workspace.
      - `active` integer, required
      - `reserved` integer, required: Approved browser and device grants that have not yet been exchanged and have not expired.
      - `remaining` integer, nullable, required
    - `resource` string, uri, required
    - `expiresAt` string, date-time, required

## Other responses

- `400`: Invalid/expired user code, invalid account selection, or missing signed-in user
- `401`: Dashboard session required
- `403`: Selected membership is unavailable
- `429`: Too many verification attempts

---

[API](https://skmtc.dev/paywithlocus/apis/locus-pro-api.md) - [All operations](https://skmtc.dev/paywithlocus/apis/locus-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paywithlocus/apis/locus-pro-api/revisions/aab8fa5d6cef?raw)