MCP tools

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.

See MCP quotas and credits for request quota, search-row quota, and contact-credit behavior.

Tools

Tool	Required scope	What it does	Side effect
`get_billing_status`	`billing:read`	Reads plan, subscription, cadence, API-access, and billing-action state. Available on Free.	None
`create_subscription_link`	`billing:manage`	Creates a Stripe-hosted subscription, exact upgrade-confirmation, or recovery link. Available on Free.	Creates a short-lived link; a human must confirm in Stripe.
`create_billing_portal_link`	`billing:manage`	Creates a Stripe-hosted management link for an existing billing account.	Creates a short-lived link; it does not change billing.
`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 masked contact records.	Uses request and search-row quota.
`reveal_contacts`	`contacts:reveal`	Reveals selected contact channels.	Can spend contact credits.

Search tools return at most 25 records per call. Domain enrichment accepts at most 10 specified domains and returns store and technology data only. Use list_taxonomy to get current filter values before building a search. search_shopify_stores accepts focused store filters:

{
  "filters": {
    "categories": ["beauty"],
    "countries": ["US"],
    "traffic_tiers": ["50K-200K", "200K-1M"],
    "apps": {
      "any": ["Klaviyo"],
      "none": ["Recharge"]
    },
    "pixels": {
      "all": ["Meta Pixel", "Google Analytics"]
    },
    "contacts": {
      "has_revealable_contacts": true,
      "roles_any": ["founder", "ecommerce_manager"]
    }
  },
  "limit": 25
}

search_shopify_contacts accepts person and store filters:

{
  "person": {
    "roles_any": ["founder", "ceo"],
    "seniority_any": ["executive"],
    "has_verified_email": true
  },
  "store": {
    "domains": ["badbirdiegolf.com"],
    "apps": {
      "any": ["Klaviyo"]
    }
  },
  "max_contacts_per_store": 3,
  "limit": 10
}

Technology filters support:

Field	Meaning
`any`	Match stores using at least one listed app or pixel.
`all`	Match stores using every listed app or pixel.
`none`	Exclude stores using any listed app or pixel.

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.
`billing:read`	Read subscription and billing status.
`billing:manage`	Create short-lived Stripe-hosted billing links.

Billing tools

Free users can connect MCP and use the billing tools. Store and contact tools remain unavailable until Stripe confirms an active paid plan. create_subscription_link accepts only StoreInspect plan and cadence values:

{
  "plan": "business",
  "billing": "annual"
}

The response contains a short-lived Stripe URL. New subscriptions created through MCP use paid Checkout and do not include a free trial. Creating the link does not subscribe, upgrade, cancel, or charge the account. A human must open the URL and confirm in Stripe. After confirmation, call get_billing_status until the webhook-reconciled plan is visible.

Contact reveal safety

The reveal_contacts tool requires explicit confirmation:

{
  "contact_ids": ["ct_AbCdEf_GhIjKlMnOpQrStUv"],
  "confirm_spend_credits": true
}

If confirm_spend_credits is missing or false, StoreInspect refuses the reveal. Use the ct_... contact IDs returned by search_shopify_contacts. Do not pass a name, role, or store domain to reveal_contacts. 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 contain only the result fields needed for the requested operation. StoreInspect keeps request identifiers in internal logs for support and abuse monitoring rather than returning them to the AI client. StoreInspect does not return raw collection records or source-processing metadata through MCP.

GETTING STARTED

REFERENCE

SECURITY

Tools

Search filters

Scopes

Billing tools

Contact reveal safety

Example prompts

Output shape

​Tools

​Search filters

​Scopes

​Billing tools

​Contact reveal safety

​Example prompts

​Output shape

Tools

Search filters

Scopes

Billing tools

Contact reveal safety

Example prompts

Output shape