Connect to Yotpo's MCP Servers

Connect Claude, Cursor and other MCP-compatible AI clients to Yotpo's MCP servers: the API docs MCP, to look up any Yotpo endpoint while you build, the Reviews MCP, to answer shopper questions from a product's reviews, and the Discover MCP, to bring your store's content, analytics and audience data into your AI workflow.

Yotpo publishes MCP (Model Context Protocol) servers that let Claude and other MCP-compatible AI clients securely access your Yotpo store's data and take actions on your behalf, without you writing any integration code.

📘

This page covers every Yotpo MCP server. As we release new servers, we'll add a new section below rather than a new page, so bookmark this page as your starting point for connecting AI tools to Yotpo.

Available MCP servers

ServerEndpointTransportWhat it's for
API docs MCPhttps://docs.yotpo.com/mcpStreamable HTTPLook up Yotpo API endpoints, parameters and schemas while you build. No login needed.
Reviews MCPhttps://api.yotpo.com/reviews/v3/mcpStreamable HTTPAnswer shopper questions about a product from its published reviews and Q&A. No login needed.
Discover MCPhttps://api.yotpo.com/discover/v3/mcpStreamable HTTPContent opportunities, content generation, and analytics for your store

The API docs MCP and the Reviews MCP are public and need no login. The Discover MCP uses OAuth 2.0: when you connect, you're redirected to log in to Yotpo and approve access, with no API key or token to copy and paste.

API docs MCP

The API docs MCP gives your AI coding tool the Yotpo API reference on docs.yotpo.com, every V3, Reviews V1, Loyalty V2, App partners and Core V1 endpoint, plus the guides and recipes. Ask it which endpoint does what, what a request needs or what a response returns, and it answers from the reference instead of guessing.

Its tools:

  • start-here-yotpo-integration-guide: maps each integration goal, for one merchant's store or for an app many merchants install, to the recipes to read, with the rules that apply across Reviews, Loyalty and Discover. AI tools should call it first when planning an integration
  • search: search the guides and recipes
  • fetch: get a guide or recipe by the ID that search or start-here returns
  • list-specs: list the API definitions, such as Yotpo API V3, Reviews API (V1) and Loyalty API (V2)
  • list-endpoints: list every path and method in an API definition, with summaries
  • search-endpoints: search paths, operations and parameters for a keyword
  • get-endpoint: get one endpoint's parameters, request body, responses, authentication and server URL
  • execute-request: send a request to the Yotpo API
🚧

execute-request calls the live API

It sends a real request with whatever credentials you or your AI tool supply. Some calls email shoppers or change data in ways you can't undo. Before you let an AI tool send requests, read Testing your integration and use a test store.

llms.txt also lists every page on this site as Markdown, for AI tools that don't use MCP. Every page also has a menu at the top with options to copy it as Markdown or connect the MCP to your editor.

Connecting the API docs MCP

  • Claude Code:

    claude mcp add --transport http yotpo-docs https://docs.yotpo.com/mcp
  • Claude.ai and Claude Desktop: go to Settings > Connectors (Claude Desktop) or Customize > Connectors (claude.ai), select Add custom connector and enter https://docs.yotpo.com/mcp.

  • VS Code: add this to .vscode/mcp.json:

    {
      "servers": {
        "yotpo-docs": {
          "type": "http",
          "url": "https://docs.yotpo.com/mcp"
        }
      }
    }
  • Cursor and other clients: add this to your client's MCP configuration:

    {
      "mcpServers": {
        "yotpo-docs": {
          "url": "https://docs.yotpo.com/mcp"
        }
      }
    }

Reviews MCP

The Reviews MCP lets an AI agent answer a shopper's questions about a product, such as "does it run small?", from the product's published reviews, Q&A and review topics. Use it in a shopping assistant, a support bot or an agentic browser. It reads only what's already public on the product page, so it needs no login and can't change anything.

  • Endpoint: https://api.yotpo.com/reviews/v3/mcp
  • Transport: Streamable HTTP
  • Authentication: none

Every tool takes your store ID as app_key and the product's ID as product_id, the same ID you send in Create product as external_id. Instead of both, you can pass a product_url and the server looks them up from the product page.

Its tools, all read-only:

  • get_product_review_summary: the product's average rating, review count, star distribution and an AI summary. Start here.
  • search_product_reviews: find reviews by text, star rating, topic, or whether they have photos.
  • get_product_reviews: page through all of a product's reviews, newest or highest-rated first.
  • get_product_topics: what reviewers talk about, with a summary and sentiment for the main topics.
  • get_product_review_attributes: sizing and fit answers reviewers gave, such as fit, size bought, height and weight.
  • get_product_questions: the product's shopper questions and the answers they got.
  • resolve_product_from_url: turn a product page URL into app_key and product_id.

Connecting the Reviews MCP

  • Claude Code:

    claude mcp add --transport http yotpo-reviews https://api.yotpo.com/reviews/v3/mcp
  • Claude.ai and Claude Desktop: go to Settings > Connectors (Claude Desktop) or Customize > Connectors (claude.ai), select Add custom connector and enter https://api.yotpo.com/reviews/v3/mcp.

  • Cursor and other clients: add this to your client's MCP configuration:

    {
      "mcpServers": {
        "yotpo-reviews": {
          "url": "https://api.yotpo.com/reviews/v3/mcp"
        }
      }
    }

Discover MCP

The Discover MCP gives an AI client read access to your store's Discover data, and the ability to kick off content generation, directly from a chat.

With it connected, you (or your AI client) can:

  • Find content opportunities based on your audience, topics, product categories, and geography
  • Generate content briefs, blog drafts, and publisher briefs, and check on their generation status
  • Query visibility, traffic-source, and shopping-journey analytics for your store
  • Run onsite brand and competitor analysis

All data returned is scoped to the Yotpo store you authenticate with.

  • Endpoint: https://api.yotpo.com/discover/v3/mcp
  • Transport: Streamable HTTP
  • Authentication: OAuth 2.0

Connecting the Discover MCP

Claude.ai and Claude Desktop

  1. Go to Settings > Connectors (Claude Desktop) or Customize > Connectors (claude.ai).
  2. Select Add custom connector.
  3. Enter a name (for example, Yotpo Discover) and the endpoint URL: https://api.yotpo.com/discover/v3/mcp.
  4. Select Connect, then log in to Yotpo and approve access when prompted.

Claude Code

Add the server from the CLI:

claude mcp add --transport http yotpo-discover https://api.yotpo.com/discover/v3/mcp

Run /mcp inside Claude Code to check connection status, or to trigger the OAuth login if you haven't authenticated yet.

Other MCP-compatible clients

Most MCP clients accept a JSON configuration block for remote servers. Add an entry like the following, then follow your client's flow to complete the OAuth login:

{
  "mcpServers": {
    "yotpo-discover": {
      "url": "https://api.yotpo.com/discover/v3/mcp"
    }
  }
}

Troubleshooting

  • Asked to log in again? OAuth sessions can expire. Reconnect the server from your client and re-approve access.
  • Seeing data from the wrong store? Disconnect and reconnect, making sure you log in with the Yotpo account tied to the store you want to access.
  • Still stuck? Reach out to Yotpo support.

Did this page help you?