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

# How intelligence credits work

> Understand which Superdata MCP requests consume credits.

An intelligence credit measures an accepted MCP intelligence tool execution.

> **1 accepted intelligence tool call = 1 intelligence credit**

The charge does not depend on runtime, result count, or which currently
available search tool is used.

## Charging rules

| Request outcome                          | Credit charge |
| ---------------------------------------- | ------------: |
| Completed with one or more results       |             1 |
| Completed with no matches                |             1 |
| Technical failure after execution begins |             1 |
| Needs clarification before execution     |             0 |
| Invalid input or invalid cursor          |             0 |
| Authentication or rate-limit rejection   |             0 |
| Insufficient-credit rejection            |             0 |

Credits are reserved before provider work starts. Repeating the same MCP
protocol request does not create a second charge while the original request is
still processing or has already completed.

## Credit sources

Your available balance can contain:

* Credits included in the current subscription cycle
* Purchased credits
* Administrator-granted credits

Superdata consumes the active grant that expires first. Subscription credits
expire at the end of their configured credit cycle unless the plan explicitly
states otherwise.

## When the balance reaches zero

The tool returns `INSUFFICIENT_CREDITS` before provider work starts. During the
private beta, contact [hey@superdata.so](mailto:hey@superdata.so) for allowance
or subscription questions.