MCP Storefront — Shopigent AI GEO

What is the MCP Storefront?

The MCP Storefront is an authenticated app endpoint. A merchant generates an API key and explicitly configures a compatible MCP client to query store products.

Instead of an AI agent having to crawl your website and guess what products you sell, it can ask your store directly:

"What wireless headphones do you have under $100?" "Compare your top 3 products by rating" "What's on sale this week?"

How It Works

The MCP Storefront implements the Model Context Protocol (MCP) — an open standard that allows AI agents to interact with external tools and data sources.

Compatible MCP Client
        │
        ▼  HTTP POST /api/mcp
        │  Authorization: Bearer <key>
        ▼
Shopigent AI GEO MCP Server
        │
        ▼  Shopify Admin API (GraphQL)
        ▼
Your Store's Products

8 Tools Available

#	Tool	What It Does	Best For
1	search_products	Search by keyword, category, price range, vendor	General product discovery
2	get_product_details	Full product info with variants, images, GEO schemas	Deep product research
3	compare_products	Side-by-side compare 2-5 products (price, availability, features)	Purchase decisions
4	get_promotions	Find products on sale with discount %	Deal hunting
5	get_store_info	Store metadata + capabilities	First contact
6	get_popular_products	Recently published products (newest first)	—
7	get_product_recommendations	Same-type product listings	Product discovery
	8	get_category_tree	Distinct product types (flat list)

Getting Started

1. Get Your API Key

1. Open your Shopigent AI GEO dashboard
2. Go to Settings → MCP Storefront
3. Click Generate Key
4. Copy the key (shown once)

2. Connect a Compatible MCP Client

Claude Desktop:

{
  "mcpServers": {
    "shopigent-ai-geo": {
      "url": "https://discovery-app-production-4a32.up.railway.app/api/mcp",
      "headers": { "Authorization": "Bearer shpg_disc_your_key_here" }
    }
  }
}

Direct API Call:

curl -X POST https://discovery-app-production-4a32.up.railway.app/api/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer shpg_disc_your_key_here" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"search_products","arguments":{"query":"wireless headphones"}},"id":1}'

Example Queries

Once connected, a compatible client can call tools for requests such as:

• "What products are in my store?" → search_products with empty query
• "Find wireless headphones under $100" → search_products with price filter
• "Compare my top 3 products" → compare_products with product IDs
• "What's on sale?" → get_promotions
• "Suggest products similar to X" → get_product_recommendations
• "Best-rated products in my store" → get_popular_products

Security

• API keys: stored as SHA-256 hashes (never plaintext)
• Rate limiting: authenticated calls are rate-limited
• Revocable: generate and revoke keys anytime from Settings

Pricing

The MCP Storefront is available on all plans:

• Free: 500 calls/month
• Growth: 10,000 calls/month
• Pro: 50,000 calls/month