--- title: "Setting Up the Yotpo MCP" slug: "setting-up-the-yotpo-mcp" description: "Use the Yotpo MCP to access your Yotpo stores' data, including analytics and loyalty reports." tags: ["Yotpo MCP", "Analytics"] updated: 2026-11-20T15:08:18Z published: 2026-11-20T15:08:18Z canonical: "support.yotpo.com/setting-up-the-yotpo-mcp" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.yotpo.com/llms.txt > Use this file to discover all available pages before exploring further. # Setting Up the Yotpo MCP Products Loyalty & Referrals ###### Supported plans All plans ###### eCommerce Platform Shopify, Shopify Plus, Adobe Commerce (Magento), BigCommerce, Salesforce Commerce Cloud, Custom ## Goals and Outcomes The Yotpo MCP lets you connect your Yotpo account to an AI assistant and ask questions about your loyalty data without searching through reports yourself. The MCP is currently built and tested with Claude. Once connected, you can use natural language to: - Look up customer, earning, and redemption information. - Get totals, averages, and breakdowns from your loyalty data. - Compare data across loyalty tiers, segments, and stores. - Combine customer, earning, and redemption data to answer more complex questions. - Identify patterns or inconsistencies in your redemption data. - Download full customer and redemption lists as CSV files. In this article, you’ll learn how to set up and use the Yotpo MCP. ## Yotpo MCP Overview ### How It Works The Yotpo MCP works as a connector inside Claude. You add it as a custom connector (without the need to request access from Yotpo) and sign in with your Yotpo account. The connection is set up at the organization level, so Claude can access every store in your organization that you have access to in Yotpo. Each report included in the MCP is available in Claude as a separate tool. You choose which of these tools Claude is allowed to use, so you have control over which loyalty data Claude can access. Learn more in Step 4 below. The MCP can answer questions about this loyalty information: - **Customer data**: ask questions about individual customers or customer groups, including loyalty tier, opt-in status, points balance, birthday, etc. - **Redemption data**: ask questions about individual reward redemptions, including which reward was redeemed, when, and how. - **Earning data**: ask questions about points that customers earned or lost, broken down by earning rule, customer, and date. Example questions and topics: - **Program size and membership**: "How many loyalty members do I have?" or "How many customers opted in each month this year?" - **Loyalty tiers**: "How many customers are in each tier?" or "List all my Gold tier customers." - **Redemptions and rewards**: "What were my top rewards last week?" or "Break down last month's redemptions by tier, reward, and source." - **Earning**: “Which earning rules gave the most points this quarter?”, “How many points were earned per month this year?” or “How many points expired last month?” - **Points balance**: "What's the average points balance by tier?" - **Customer lists**: "Which customers have a lifetime spend over $500?" - **Combined questions**: "Which rewards have my VIP customers redeemed this quarter?" You can also use the MCP for recurring reporting. For example, ask Claude to build a monthly rewards report with redemptions by tier and reward, new opt-ins, and your top spenders. > [!WARNING] > Note > > Questions that combine data from multiple reports may take longer to answer as Claude needs to retrieve and match information from all data sets. ### Downloading Reports When a result is large, Claude may show only a sample or a summary in the chat. To get the full list, ask Claude to download the report. Claude creates a link to a CSV file with up to 50,000 rows. - Downloads are available for customer, earning, and redemption data. - To get more than 50,000 rows, download the full report from the **Reports** page in the Yotpo admin. ### Multi-Store Access Claude can see every active store in your organization, so you don’t need to disconnect and reconnect to switch stores. - **See your stores**: Ask “Which stores can you see?” to get the list. - **Ask about a specific store**: Name the store in your question, for example, “What were my top rewards last month in my UK store?” - **Compare stores**: You can compare several stores in one question. Claude pulls data from each store separately, so these answers take longer. Each answer shows the store name at the top, so you can confirm which store the data comes from. ### Limitations Keep the following limitations in mind when using the Loyalty MCP: - **Read-only access**: The MCP can view and report on your loyalty data, but it can’t change loyalty settings, issue or take back rewards, or edit customer records. - **Report data only**: The MCP only answers from Customer, Redemption, and Earning report data. Metrics outside these reports aren’t covered, such as revenue from redemption orders, tier history, referrals, or points liability. - **Claude only**: The MCP is built and tested with Claude only. Other AI assistants aren’t supported yet. - **AI-generated responses**: Claude decides how to search, combine, and explain the data it gets from the MCP. While the underlying loyalty data comes from Yotpo, Claude may misunderstand a question, combine data incorrectly, or provide an inaccurate interpretation. > [!WARNING] > Important > > Always verify important information against your Yotpo data before making business decisions based on an AI-generated response. ### Data Security and Privacy The Yotpo MCP uses secure OAuth 2.0 sign-in, so each user connects with their own Yotpo credentials. There are no API keys to manage, and Claude never sees your password. The MCP can only access stores in your organization that you have access to in Yotpo, and you can revoke access at any time by disconnecting it in Claude. > [!WARNING] > Important > > The data Claude retrieves through the Yotpo MCP, including details about your loyalty customers, is sent to Anthropic and handled under Anthropic's terms and your Claude plan and settings. Yotpo doesn't control how Anthropic processes, stores, or uses this data. Before connecting, make sure your Claude setup meets your company's privacy requirements. Learn more in the [Anthropic Privacy Center](https://privacy.claude.com), including [whether your data is used for model training](https://privacy.claude.com/en/articles/12109829-how-do-i-change-my-model-improvement-privacy-settings). ### Requirements To use the Yotpo MCP, you need: - An active Yotpo Loyalty & Referrals account. - A Claude account. - Your Yotpo login credentials to authorize the connection. ## Connecting the MCP ![Setting up the Yotpo MCP in claude](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/yotpo-mcp-setup-claude.gif?sv=2026-02-06&spr=https&st=2026-11-21T13%3A20%3A10Z&se=2026-11-21T14%3A20%3A10Z&sr=b&sp=r&sig=YM4MjnrinB2Oi%2Fvhxocvieeq6PTDkBn5r4IKMNkd5hw%3D) ### Step 1. Copy the connector URL 1. From your **Yotpo Loyalty admin**, go to [**Integrations**](https://loyalty-app.yotpo.com/integrations-center). 2. Open the **Claude** tile. 3. Copy the **connector URL**: [https://api.yotpo.com/platform/v3/mcp](https://api.yotpo.com/platform/v3/mcp) ### Step 2. Add the connector in Claude 1. In Claude, go to **Settings** > **Connectors** > **Add custom connector**. 2. Give the connector a name you will recognize, such as **Yotpo**. 3. Paste the **connector URL** you copied in Step 1. ### Step 3. Connect your Yotpo account 1. Click **Add**, then click **Connect**. A Yotpo login screen opens in your browser. 2. **Sign in** to your Yotpo account. 3. Click **Allow** to approve access. You’re now connected to your organization, including all the stores you can access in Yotpo. ### Step 4. Allow the Report Tools Each report in the MCP appears in Claude as a separate tool. Claude can only use the reports you allow, so you need to allow them before you can use the connector. 1. In Claude, go to **Settings** > **Connectors** and select the Yotpo MCP connector. 2. Under **Tool permissions**, allow each loyalty report tool you want Claude to use: 1. Customer report 2. Redemption report 3. Earning report 4. Customer export 5. Redemption export 6. List stores ### Step 5. Test the connection After connecting, ask Claude a simple question to confirm that the MCP can access your Yotpo data, such as: “Which Yotpo stores can you see?” followed by “How many loyalty members do I have in [store name]?” If Claude returns your store list and loyalty data, the connection is ready to use.