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
| Server | Endpoint | Transport | What it's for |
|---|---|---|---|
| API docs MCP | https://docs.yotpo.com/mcp | Streamable HTTP | Look up Yotpo API endpoints, parameters and schemas while you build. No login needed. |
| Reviews MCP | https://api.yotpo.com/reviews/v3/mcp | Streamable HTTP | Answer shopper questions about a product from its published reviews and Q&A. No login needed. |
| Discover MCP | https://api.yotpo.com/discover/v3/mcp | Streamable HTTP | Content 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 APIIt 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_keyandproduct_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
- Go to Settings > Connectors (Claude Desktop) or Customize > Connectors (claude.ai).
- Select Add custom connector.
- Enter a name (for example,
Yotpo Discover) and the endpoint URL:https://api.yotpo.com/discover/v3/mcp. - 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/mcpRun /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.
Updated 10 days ago
