> ## Documentation Index
> Fetch the complete documentation index at: https://dev.jolts.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Read usage and results

> Check account limits or retrieve an operation without starting another search.

`get_usage` is an authenticated Jolts MCP tool. [Connect your assistant](/mcp-overview) first.

## Arguments

| Argument | Type    | Requirement                                                              |
| -------- | ------- | ------------------------------------------------------------------------ |
| `id`     | Integer | Optional; omit for account allowance, supply an operation ID for results |

No request key is required. Unknown arguments are rejected. The examples below are the `params`
object of a JSON-RPC `tools/call`.

<CodeGroup>
  ```json Read an operation theme={null}
  { "name": "get_usage", "arguments": { "id": 789 } }
  ```

  ```json Read account limits theme={null}
  { "name": "get_usage", "arguments": {} }
  ```
</CodeGroup>

Optional `id` is an integer. With an ID, returns the account-owned operation's status or results;
without it, returns subscription usage and limits. Neither read is metered. An ID from another
account returns `usage_not_found`.

## Read the response

Read `result.structuredContent`; text-only clients receive the same JSON in `result.content`.
Check `result.isError` before using data. A successful HTTP status alone does not prove tool success.
See [response examples](/mcp-responses) and [error handling](/troubleshooting).

With no ID, read the [account usage response](/api-reference/account/get-subscription-usage).
With an ID, the response depends on the original operation: a pending status, company search,
company lookup, or historical operation result. Do not assume every response contains companies.

For a pending or processing operation, wait before polling again. Stop when results or a terminal
error arrive. If the call itself fails, inspect its structured error rather than starting a new
search. Polling and replay do not refresh the original evidence or perform new provider research.

## Related

* [Choose a tool](/mcp-tools)
* [Company-list workflows](/workflows)
* [Understand evidence](/evidence)