---
title: "Get Mcp Quota"
method: GET
path: "/v1/mcp/quota"
tags: ["MCP"]
---

# Get Mcp Quota

`GET /v1/mcp/quota`

## Request

- Base URL: `https://api.pinbridge.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pinbridge.io/v1/mcp/quota`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Return current week MCP request usage and quota for the workspace.

Called by the MCP server before each tool call to enforce the weekly limit.
Returns quota_exhausted=true when the limit is reached, with ``upgrade``
carrying the message and pricing link to show. A limit of 0 means unlimited.

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- QuotaResponse
  - `week` string, required
  - `requests_used` integer, required
  - `requests_limit` integer, required
  - `quota_exhausted` boolean, required
  - `resets_at` string, required
  - `plan` string, required
  - `plan_name` string, required
  - `upgrade` UpgradeInfo: What to tell the person once the week's requests are used up.
    - `message` string, required
    - `remediation` string, required
    - `upgrade_url` string, nullable
    - `limit_type` string, required
    - `plan` string, required
    - `plan_name` string, required
    - `limit` integer, nullable
    - `used` integer, nullable
    - `resets_at` string, nullable
    - `recommended_plan` string, nullable
    - `recommended_plan_name` string, nullable
    - `recommended_limit` integer, nullable

## Other responses

- `422`: Validation Error

---

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