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:
The client should call get_usage and return plan, API access, request quota, search-row usage, and shared contact credits. Trial users also see the current 250-credit trial cap and the paid-plan credit total.

​
Request and search-row quotas

Store and contact search tools use quota because they return rows from the StoreInspect index. 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.
  • Trial users receive 250 contact credits during the trial. Paid Pro includes 1,000 monthly contact credits.
  • 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.
  • When trial credits are exhausted, reveal_contacts returns a billing action that points to the billing page for unlocking paid Pro credits immediately.

​
Reveal confirmation

The reveal_contacts tool requires:
If confirm_spend_credits is missing or false, StoreInspect refuses the reveal. The contact_ids values must be the ct_... IDs returned by contact preview results. Names, roles, and store domains cannot be used as reveal IDs.

​
Cost-control prompts

Use preview-first prompts:
Then ask for a shortlist:
Reveal only after review:

​
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.