Shopigent AI GEO

MCP Storefront

What is the MCP Storefront?

The MCP Storefront is a public API endpoint that AI agents (like ChatGPT, Claude, Gemini, Perplexity, and Copilot) can connect to and query your store's products in real time.

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.

AI Agent (ChatGPT, Claude, etc.)
        │
        ▼  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, rating, 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 Popular products (by ratings when available) Best-sellers
7 get_product_recommendations Related product suggestions Product suggestions
8 get_category_tree Product categories list Store browsing

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 Your AI Agent

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, you can ask your AI agent:

  • "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: 60 req/min public, 300 req/min authenticated
  • Audit logging: all calls logged with timestamp, tool, and status
  • Revocable: generate and revoke keys anytime from Settings

Pricing

The MCP Storefront is available on all plans (Free — 500 monthly calls, Growth — 10,000, Pro — unlimited).