MCP Storefront — Shopigent AI GEO

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI agents to interact with tools and data sources. Shopigent AI GEO implements an MCP server that lets AI agents query your store's products directly.

Available Tools

Tool	Description
`search_products`	Search products by keyword, category, price range, vendor
`get_product_details`	Get full product details with GEO schemas
`compare_products`	Compare 2-5 products side-by-side
`get_promotions`	Find products on sale with discount percentages
`get_store_info`	Get store metadata and capabilities
`get_popular_products`	Recently published products (newest first)
`get_product_recommendations`	Same product type, excluding the source product
`get_category_tree`	Distinct product types (flat list)

Endpoint

POST https://discovery-app-production-4a32.up.railway.app/api/mcp
Authorization: Bearer <your-api-key>
Content-Type: application/json

Authentication

Generate an API key from the Shopigent AI GEO dashboard → Settings → MCP Storefront.

Rate Limits

Public: 60 requests/minute (tools/list, initialize only)
Authenticated: 300 requests/minute

Example

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_products",
    "arguments": {
      "query": "wireless earbuds",
      "maxPrice": 100,
      "sortBy": "rating"
    }
  },
  "id": 1
}