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

# MCP quotas and credits

> Understand how StoreInspect MCP uses request quotas, search-row quotas, and shared contact credits.

StoreInspect MCP uses the same account access model as the StoreInspect API. Tool calls are tied to the StoreInspect account you approve during OAuth.

## Check current usage

Ask your client:

```text theme={null}
Use StoreInspect to show my current usage.
```

The client should call `get_usage` and return plan, API access, request quota, search-row usage, and shared contact credits.

## Request and search-row quotas

Store and contact search tools use quota because they return rows from the StoreInspect index.

| Tool                      | Quota behavior                           |
| ------------------------- | ---------------------------------------- |
| `get_usage`               | Reads quota and credit state.            |
| `list_taxonomy`           | Reads supported filters.                 |
| `get_shopify_store`       | Looks up one store by domain.            |
| `search_shopify_stores`   | Uses request quota and search-row quota. |
| `enrich_shopify_domains`  | Uses request quota and search-row quota. |
| `search_shopify_contacts` | Uses request quota and search-row quota. |
| `reveal_contacts`         | Can spend shared contact credits.        |

Before a search or enrichment tool runs, StoreInspect checks that the requested
limit fits within your monthly search-row quota. After the tool completes, usage
reporting reflects the rows actually returned.

## Contact credits

Contact credits are shared across the StoreInspect web app, REST API, and MCP.

* Contact search previews do not expose raw emails, phone numbers, or LinkedIn URLs.
* Revealing a contact for the first time spends one shared contact credit.
* Re-revealing a contact already revealed to your account does not spend another credit.
* StoreInspect refuses MCP reveals unless the tool input includes explicit credit-spend confirmation.

## Reveal confirmation

The `reveal_contacts` tool requires:

```json theme={null}
{
  "contact_ids": ["ct_AbCdEf_GhIjKlMnOpQrStUv"],
  "confirm_spend_credits": true
}
```

If `confirm_spend_credits` is missing or false, StoreInspect refuses the reveal.

## Cost-control prompts

Use preview-first prompts:

```text theme={null}
Search for ecommerce decision-maker contacts at these stores. Do not reveal contact channels yet.
```

Then ask for a shortlist:

```text theme={null}
Rank the best 10 contacts to reveal and show the contact IDs. Do not spend credits.
```

Reveal only after review:

```text theme={null}
Reveal these three contact IDs and confirm spending contact credits.
```

## Focus searches

Search endpoints are intended for focused ICP workflows. Use filters such as country, category, traffic tier, app usage, missing app, pixel, theme, Shopify Plus, Meta ads, contact role, or revealable-contact availability.

<Warning>
  Do not use MCP tools to crawl, resell, or reconstruct the StoreInspect dataset.
</Warning>