Skip to main content
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:
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.
ToolQuota behavior
get_usageReads quota and credit state.
list_taxonomyReads supported filters.
get_shopify_storeLooks up one store by domain.
search_shopify_storesUses request quota and search-row quota.
enrich_shopify_domainsUses request quota and search-row quota.
search_shopify_contactsUses request quota and search-row quota.
reveal_contactsCan 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:
{
  "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:
Search for ecommerce decision-maker contacts at these stores. Do not reveal contact channels yet.
Then ask for a shortlist:
Rank the best 10 contacts to reveal and show the contact IDs. Do not spend credits.
Reveal only after review:
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.
Do not use MCP tools to crawl, resell, or reconstruct the StoreInspect dataset.