> For the complete documentation index, see [llms.txt](https://mcp-docs.nichefire.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mcp-docs.nichefire.com/tools/get-usage.md).

# Get Usage

Check your remaining quota and rate limit at any time.

### `get_usage`

### What it does

Returns your organization's current usage across every feature you have access to, grouped by feature:

* `firesearch` for live research
* `insights` for Trend Insights.

Each feature reports its **rate limit**: how many calls are allowed per window, how many remain, and when the window resets. Features that meter a fixed allowance also report a **quota**: the total, how much has been used, and how much is left. Features without a quota omit the field entirely.

### When to use it

* Before running several searches in a row, to confirm how much of the shared quota is left.
* When a call fails with a rate-limit or quota error, to see whether you need to wait for the window to reset or the allowance has run out entirely.
* Any time you want to report remaining balance without spending anything to find out.

Because the quota is shared across your whole organization, the numbers reflect everyone's usage, not just yours.

### Parameters

None.

### Cost

Free. `get_usage` never consumes quota and never counts against your rate limit.

### Example response

```json
{
  "usage": {
    "firesearch": {
      "rate_limit": { "limit": 60, "remaining": 59, "reset_at": "2026-07-23T14:05:00Z", "window_seconds": 60 },
      "quota": { "limit": 1000, "used": 1, "remaining": 999 }
    },
    "insights": {
      "rate_limit": { "limit": 100, "remaining": 97, "reset_at": "2026-07-23T14:05:00Z", "window_seconds": 60 }
    }
  }
}
```

Reading the example: this organization may make 60 Firesearch calls per minute and has 999 of its 1,000 searches left. Trend Insights is rate-limited at 100 calls per minute but has no fixed allowance — reading your own saved data is unmetered.

Only the features you have access to appear in the response, so this is also the quickest way to confirm what your organization is entitled to.\
\
`get_usage` reports your balance; it does not explain the rules behind it. See [Quotas & Rate Limits](/errors-and-limits/errors.md) for how the allowance is calculated, when it resets, and how to raise it.