Skip to content
Help Center

Frequently Asked Questions

Answers to common questions about AgenticMCPStores: platform overview, merchant integration, developer API, and AI agent capabilities.

General

What is AgenticMCPStores?

AgenticMCPStores is a multi-merchant trust and execution layer for agentic commerce. It connects Shopify and WooCommerce stores with AI assistants like ChatGPT and Claude via the MCP (Model Context Protocol), enabling product discovery, catalog browsing, and checkout initiation without rebuilding core operations.

Is AgenticMCPStores free?

Yes. The current beta access is completely free. Connect one store, expose your catalog to AI agents, and validate traffic before scaling. Paid plans will be introduced when they earn their place — lower commission, more visibility, better measurement.

Which AI assistants work with AgenticMCPStores?

Any AI assistant that supports MCP (Model Context Protocol) — including Claude, ChatGPT plugins, and custom LLM agents — can connect to AgenticMCPStores. Agents built with the WebMCP SDK can also interact via browser.

How long does onboarding take?

Under 5 minutes. Select your platform (Shopify or WooCommerce), enter your store URL and API credentials, configure agent capabilities, and your store is live in the agentic commerce network.

For Merchants

Do I need to modify my Shopify or WooCommerce store?

No. The integration uses your existing store API. We read your catalog, pricing, stock, return policy, and shipping rules — no code changes to your storefront required.

What data does AgenticMCPStores access?

We access catalog data (products, prices, stock), store policies (returns, shipping), and order status after checkout. We never store personal customer data. Your API keys are encrypted with AES-256.

Can I control what AI agents can do in my store?

Yes. You set the rules: which categories agents can access, maximum order values, and whether specific actions require human confirmation. Agents cannot exceed the permissions you configure.

How does the Trust Score affect my store?

The Trust Score (0.0–1.0) determines your store's visibility in agent search results. Stores with score ≥ 0.5 appear in the primary tier. Scores between 0.3–0.5 are deprioritized. Below 0.3 or suspended stores are hidden. Improve your score by keeping catalog data fresh, accurate pricing, and high fulfillment rates.

For Developers

What authentication does the Agent API use?

The Agent API uses API keys with the prefix agnt_. Create keys via POST /api/v1/agent-keys with your JWT. Keys support scoped permissions: agent:read (catalog browsing), agent:cart (cart creation), agent:checkout (checkout initiation). Include the key in the X-Agent-Api-Key header.

What is the MCP endpoint format?

Each store gets a unique MCP endpoint at /mcp/{store-slug}. The global MCP server at /mcp serves all connected stores and accepts search queries across the full catalog. Supports both streamable-http transport and SSE fallback at /mcp/sse.

How do I verify webhook payloads?

All webhook POSTs include an X-Webhook-Signature header containing an HMAC-SHA256 signature. Compute HMAC-SHA256 of the raw request body using your webhook secret and compare with the header value. Reject requests where signatures don't match.

Is there an OpenAPI spec?

Yes. The full OpenAPI 3.0 spec is available at /api/openapi.json. Import it into Postman, Insomnia, or any OpenAPI-compatible tool. An interactive Swagger UI is available at /api/docs.

For AI Agents

How does an AI agent discover AgenticMCPStores?

AgenticMCPStores exposes multiple discovery layers: /.well-known/merchant-index.json (full merchant registry — slug, categories, trust_score, mcp_endpoint, freshness; ISR 5 min, no auth required), /.well-known/agent-commerce.json (canonical contract with endpoints, auth, rate limits, trust framework, and directories), /mcp.json (MCP manifest with all tools), /.well-known/ai-plugin.json (ChatGPT/OpenAI compatible), and <link rel='mcp'> tags in every page head for browser-based agents.

Which actions require human confirmation?

Cart creation and checkout initiation always require explicit human confirmation. Read-only operations (search, product detail, availability, merchant profile) never require confirmation. The confirmation threshold is also configurable per merchant — by default, any order above $100 triggers an additional confirmation step.

What is the agent ranking formula?

relevanceScore = (text_relevance × 0.55) + (store_trust_score × 0.25) + (freshness × 0.10) + (in_stock × 0.10). Stores with trustScore < 0.5 are always placed after all active-tier stores regardless of their computed relevanceScore — this is a hard two-tier sort, not a tiebreaker.

Does AgenticMCPStores process payments?

No. AgenticMCPStores is not a payment processor and not a merchant of record. The checkout tool returns a checkout URL that redirects to the merchant's native checkout (Shopify Payments, WooCommerce, etc.). Payments happen on the merchant's platform, not ours.

Ready to get started?

Join the beta for free and connect your store to AI agents in minutes.

Create free account
FAQ — Frequently Asked Questions | AgenticMCPStores