> ## 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. Tool availability can depend on the OAuth scopes granted to the connected client and the current StoreInspect plan. See [MCP quotas and credits](/docs/mcp/quotas-and-credits) for request quota, search-row quota, and contact-credit behavior. Claude connects through `https://mcp.storeinspect.com/claude`. Active Free accounts can use the data tools on that endpoint. ## 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 on the general and ChatGPT endpoints. Claude Free preview searches return at most 50 records per call. Domain enrichment accepts at most 10 specified domains and returns store and technology data only. ## Search filters Use `list_taxonomy` to get current filter values before building a search. `search_shopify_stores` accepts focused store filters: ```json theme={null} { "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: ```json theme={null} { "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 are also available to active Free accounts through the dedicated Claude endpoint; other MCP clients require an active paid plan. `create_subscription_link` accepts only StoreInspect plan and cadence values: ```json theme={null} { "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: ```json theme={null} { "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](/docs/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 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.