{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"REVER Analytics MCP (Beta)","description":"Integrate with REVER return process engine","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"rever-analytics-mcp-beta","__idx":0},"children":["REVER Analytics MCP (Beta)"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Beta"]},": the REVER Analytics MCP is in beta. It works and you can use it today, but the available tools, prompts and answers are still evolving, and some questions may not be supported yet. Expect changes, and please send any feedback or missing capabilities to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:feedback@itsrever.com"},"children":["feedback@itsrever.com"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The REVER Analytics MCP is a remote ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://modelcontextprotocol.io"},"children":["Model Context Protocol"]}," server that connects your AI assistant to your REVER returns and orders data. Once connected, you can ask questions in natural language and the assistant queries REVER on your behalf: no dashboard, no manual export."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/analytics-mcp-cover.86127ba93c29f1c7e51f8614f3ffecdacebf0989a1e7da682910af777a762adb.9c1bb791.svg","alt":"REVER Analytics MCP"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use it to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Find definitions for key metrics"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Track how your metrics evolve over time"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Break down and compare your returns data by product, variant, reason, or period"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create tailored queries and data exports"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Explore other insights from your REVER data"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The server only exposes data for the e-commerce your REVER account belongs to."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A REVER account, the same one you use to log in to the REVER dashboard. Anyone with dashboard access can use the MCP; no extra approval or API key is needed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An MCP-capable client, installed and up to date: Claude Desktop, Claude Code, ChatGPT, Cursor, VS Code with GitHub Copilot, or Codex."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connection-details","__idx":2},"children":["Connection details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All clients use the same values. Authentication is OAuth 2.0 with your REVER login; the client opens a browser window where you sign in."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Server URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://analytics-mcp.itsrever.com/mcp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transport"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Streamable HTTP"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth 2.0 (REVER login)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth Client ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kh8FOHYbopPqT3gj3zZMhwbdJBX7T1mS"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth Client Secret"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Leave empty"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Client ID is a public identifier and is safe to share. There is no client secret."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"setup-by-client","__idx":3},"children":["Setup by client"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"claude-desktop-and-claude-code","__idx":4},"children":["Claude Desktop and Claude Code"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]},", then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connectors"]},", then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add custom connector"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fill in the form:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REVER Analytics MCP"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remote MCP server URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://analytics-mcp.itsrever.com/mcp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth Client ID (Advanced settings)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kh8FOHYbopPqT3gj3zZMhwbdJBX7T1mS"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth Client Secret (Advanced settings)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Leave empty"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add"]},". Claude opens the login flow in your browser. Sign in with your REVER account."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["From the Claude Code terminal you can add the server directly:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"claude mcp add --transport http rever-analytics https://analytics-mcp.itsrever.com/mcp\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Then run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]},", select ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rever-analytics"]},", and complete the login in the browser."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"chatgpt","__idx":5},"children":["ChatGPT"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ChatGPT hides custom connectors behind Developer mode and requires a paid plan (Plus, Pro, Team, or Enterprise)."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]},", then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connectors"]},", scroll to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Advanced settings"]}," and turn on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Developer mode"]},". This is a one-time step."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add custom connector"]}," and fill in the form:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REVER Analytics MCP"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Server URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://analytics-mcp.itsrever.com/mcp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OAuth"]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Advanced OAuth configuration"]},", then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Registration method"]},", and switch it to the user-defined OAuth client option. Two new fields appear:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth Client ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kh8FOHYbopPqT3gj3zZMhwbdJBX7T1mS"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth Client Secret (optional)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Leave empty"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorize"]}," to open the login flow in your browser."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cursor","__idx":6},"children":["Cursor"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cursor Settings"]},", then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP"]},", then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add new global MCP server"]},". For a project-scoped server, add the config to the project's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".cursor/mcp.json"]}," instead."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Paste this configuration:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"REVER-analytics\": {\n      \"url\": \"https://analytics-mcp.itsrever.com/mcp\",\n      \"auth\": {\n        \"CLIENT_ID\": \"Kh8FOHYbopPqT3gj3zZMhwbdJBX7T1mS\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enable or refresh the server from ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cursor Settings"]},", then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP"]},". Cursor opens the login flow in your browser."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"vs-code-github-copilot","__idx":7},"children":["VS Code (GitHub Copilot)"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".vscode/mcp.json"]}," in your workspace, or run ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP: Add Server"]}," from the Command Palette."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Paste this configuration:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"servers\": {\n    \"REVER-analytics\": {\n      \"type\": \"http\",\n      \"url\": \"https://analytics-mcp.itsrever.com/mcp\",\n      \"oauth\": {\n        \"clientId\": \"Kh8FOHYbopPqT3gj3zZMhwbdJBX7T1mS\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["From the Command Palette run ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP: List Servers"]},", select ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REVER-analytics"]},", then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Start Server"]},". This triggers the login flow in your browser."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Copilot Chat"]}," and switch the mode to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agent"]},". MCP tools only run in Agent mode. Click the tools icon to confirm the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REVER-analytics"]}," tools are listed."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"codex-openai","__idx":8},"children":["Codex (OpenAI)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Codex needs one setting the other clients do not: a fixed port for the login callback. REVER accepts a single pre-registered port, so use the values below exactly as written."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.codex/config.toml"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".codex/config.toml"]}," in your project for a project-scoped server, and add:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"toml","header":{"controls":{"copy":{}}},"source":"[mcp_servers.rever-analytics]\nurl = \"https://analytics-mcp.itsrever.com/mcp\"\n\n[mcp_servers.rever-analytics.oauth]\nclient_id = \"Kh8FOHYbopPqT3gj3zZMhwbdJBX7T1mS\"\ncallback_port = 8391\ncallback_url = \"http://127.0.0.1/callback\"\n","lang":"toml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Leave ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callback_url"]}," without a port number. Codex fills in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callback_port"]}," itself, and the login is rejected if either line is missing or changed."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["codex mcp login rever-analytics"]},". Codex opens the login flow in your browser. Sign in with your REVER account."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["codex mcp list"]}," to confirm the server is connected."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"other-mcp-clients","__idx":9},"children":["Other MCP clients"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Any client that supports remote MCP servers over Streamable HTTP with OAuth 2.0 can connect using the values in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#connection-details"},"children":["Connection details"]},". Most clients only need the server URL and the Client ID."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"predefined-prompts","__idx":10},"children":["Predefined prompts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The server ships prompts for the most common analytical questions. Clients that support MCP prompts list them as slash commands or suggestion chips:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Prompt"},"children":["Prompt"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default period"},"children":["Default period"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return-rate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return rate evolution over the last 6 months"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product-performance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product return performance over the last 3 months"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return-reasons"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return reasons breakdown over the last 3 months"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["compensation-methods"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Compensation methods breakdown over the last 3 months"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refund-methods"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refund methods breakdown over the last 3 months"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each prompt accepts an optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["period"]}," argument to change the time range."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"good-to-know","__idx":11},"children":["Good to know"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data freshness"]},": analytics data is refreshed daily, so figures for today may be incomplete."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scope"]},": every query is scoped to your e-commerce. You cannot see data from other REVER merchants."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read-only"]},": the MCP only reads data. It cannot create, modify or cancel returns. Use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/admin"},"children":["Admin API"]}," for that."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":12},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The login is rejected or the connector shows as misconfigured"]},": this is not something on your end. Reach out to your REVER contact or email ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:feedback@itsrever.com"},"children":["feedback@itsrever.com"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Codex reports that the callback is not registered"]},": check that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callback_port"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8391"]},", that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callback_url"]}," has no port number, and that nothing else on your machine is using port 8391."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The tools do not appear in the client"]},": make sure the server is started and authorized. In VS Code, MCP tools are only available in Agent mode."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The connector shows a generic icon"]},": some clients ignore the icon provided by custom MCP servers. This is expected and does not affect functionality."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["During the beta, the set of tools and prompts may change without notice. If you find a question it cannot answer or a capability you are missing, let us know at ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:feedback@itsrever.com"},"children":["feedback@itsrever.com"]},"."]}]},"headings":[{"value":"REVER Analytics MCP (Beta)","id":"rever-analytics-mcp-beta","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Connection details","id":"connection-details","depth":2},{"value":"Setup by client","id":"setup-by-client","depth":2},{"value":"Claude Desktop and Claude Code","id":"claude-desktop-and-claude-code","depth":3},{"value":"ChatGPT","id":"chatgpt","depth":3},{"value":"Cursor","id":"cursor","depth":3},{"value":"VS Code (GitHub Copilot)","id":"vs-code-github-copilot","depth":3},{"value":"Codex (OpenAI)","id":"codex-openai","depth":3},{"value":"Other MCP clients","id":"other-mcp-clients","depth":3},{"value":"Predefined prompts","id":"predefined-prompts","depth":2},{"value":"Good to know","id":"good-to-know","depth":2},{"value":"Troubleshooting","id":"troubleshooting","depth":2}],"frontmatter":{"title":"REVER Analytics MCP (Beta)","seo":{"title":"REVER Analytics MCP (Beta)"}},"lastModified":"2026-09-17T10:41:25.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/analytics-mcp","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}