StoreInspect MCP exposes focused tools over the same store and contact intelligence used by the REST API.
Tool availability can depend on the OAuth scopes granted to the connected client and the current StoreInspect plan.
| 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. |
reveal_contacts tool requires explicit confirmation:
{
"contact_ids": ["ct_AbCdEf_GhIjKlMnOpQrStUv"],
"confirm_spend_credits": true
}
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.
Use StoreInspect to find 25 US Shopify Plus beauty stores using Meta Pixel but not Klaviyo.
Use StoreInspect to search for founder or ecommerce decision-maker contacts at those stores. Do not reveal contact channels yet.
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. 
