---
title: "Track Mcp Request"
method: POST
path: "/v1/mcp/track"
tags: ["MCP"]
---

# Track Mcp Request

`POST /v1/mcp/track`

## 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/track`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Increment MCP request counter for the workspace.

Called by the MCP server after each tool call. Uses an atomic
INSERT ... ON CONFLICT DO UPDATE to safely upsert the weekly row.
Returns the updated usage state including whether quota is now exhausted.

## Headers

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

## Response `200`

Successful Response

- TrackResponse
  - `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)