> ## 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 tools

> StoreInspect MCP tools, required OAuth scopes, and credit behavior.

StoreInspect MCP exposes focused tools over the same store and contact intelligence used by the REST API.

<Info>
  Tool availability can depend on the OAuth scopes granted to the connected client and the current StoreInspect plan.
</Info>

See [MCP quotas and credits](/mcp/quotas-and-credits) for request quota, search-row quota, and contact-credit behavior.

## Tools

| Tool                      | Required scope    | What it does                                                                                                      | Side effect                        |
| ------------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| `get_usage`               | `usage:read`      | Reads plan, quota, search-row usage, and shared contact credits.                                                  | None                               |
| `list_taxonomy`           | `stores:read`     | Lists supported filters such as countries, categories, apps, pixels, themes, roles, seniority, and traffic tiers. | None                               |
| `get_shopify_store`       | `stores:read`     | Gets one Shopify store by domain.                                                                                 | None                               |
| `search_shopify_stores`   | `stores:read`     | Searches Shopify stores by ICP filters.                                                                           | Uses request and search-row quota. |
| `enrich_shopify_domains`  | `stores:read`     | Enriches known Shopify domains from the StoreInspect index.                                                       | Uses request and search-row quota. |
| `search_shopify_contacts` | `contacts:search` | Searches preview-safe contact records.                                                                            | Uses request and search-row quota. |
| `reveal_contacts`         | `contacts:reveal` | Reveals selected contact channels.                                                                                | Can spend contact credits.         |

## Scopes

| Scope             | Meaning                                                                    |
| ----------------- | -------------------------------------------------------------------------- |
| `usage:read`      | Read plan, API quota, search-row quota, and contact-credit usage.          |
| `stores:read`     | Read store records, taxonomy, store search, and domain enrichment results. |
| `contacts:search` | Search contact previews without exposing private channels.                 |
| `contacts:reveal` | Reveal contact channels after explicit confirmation.                       |

## Contact reveal safety

The `reveal_contacts` tool requires explicit confirmation:

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

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

Reveal rules:

* Contact search previews do not return raw email, phone, or LinkedIn URL.
* 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.
* Reveals use the same monthly contact-credit pool as the StoreInspect web app and REST API.

## Example prompts

For full prompt sequences, see [MCP example workflows](/mcp/example-workflows).

```text theme={null}
Use StoreInspect to find 25 US Shopify Plus beauty stores using Meta Pixel but not Klaviyo.
```

```text theme={null}
Use StoreInspect to search for founder or ecommerce decision-maker contacts at those stores. Do not reveal contact channels yet.
```

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

## Output shape

MCP responses are compact, AI-readable JSON. Responses include a `request_id` for support and debugging.

StoreInspect does not return raw collection records or source-processing metadata through MCP.