Connect to Yotpo's MCP Servers

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.

Available MCP servers

The API docs MCP is public and needs 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. 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:

• 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.

🚧

Core V3 calls fail if your MCP client sends an Authorization header

The MCP passes your client's own headers on to the API. If your client sends an Authorization header, for example one set in your MCP config, Yotpo API V3 calls such as Retrieve products return 401 {"message":"Bad token; invalid JSON"}, even with a valid X-Yotpo-Token. Generate access token and the Loyalty API aren't affected. Remove that header from your MCP config. If your client adds it and you can't remove it, send the call with curl.

The MCP covers the API reference only. For guides and recipes, point your AI tool at llms.txt, which lists every page on this site as Markdown. 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:

  Bash

  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:

  JSON

  {
    "servers": {
      "yotpo-docs": {
        "type": "http",
        "url": "https://docs.yotpo.com/mcp"
      }
    }
  }

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

  JSON

  {
    "mcpServers": {
      "yotpo-docs": {
        "url": "https://docs.yotpo.com/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.