Docs

Turbodato MCP server

Ask Claude about your competitors' prices. The Turbodato connector gives Claude read-only access to the price-monitoring dashboards you already see in Turbodato.

Overview

Turbodato monitors the prices of your products across online retailers and marketplaces every day and compares them against your own site. The MCP server exposes that data to Claude — and to any other client that speaks the Model Context Protocol — so you can ask questions in plain language instead of filtering the dashboard by hand:

  • “Which of my products are cheaper at a competitor today?”
  • “Who is selling the Acme 500 ml below our suggested retail price?”
  • “How did our price position on the Beverages category change this week?”
  • “Export the price matrix for brand X and summarize the biggest gaps.”

The connector is read-only. It cannot change prices, products, alerts or any setting in your account.

Requirements

  • A Turbodato account with access to at least one dashboard. Turbodato is a paid product; if you don't have an account yet, book a call.
  • An MCP client that supports remote servers with OAuth — Claude (web, desktop and mobile), Claude Code, or others.

Connecting

Server URL:

https://app.turbodato.com/api/mcp

Transport: Streamable HTTP. Authentication: OAuth 2.1 with dynamic client registration — there is no API key to paste.

Claude (web, desktop, mobile)

  • Open Settings → Connectors and add Turbodato from the directory, or choose Add custom connector and paste the server URL above.
  • Click Connect. A Turbodato window opens: sign in with your usual Turbodato credentials (if you're already signed in you go straight to the next step).
  • Review the request and click Allow. You're sent back to Claude and the tools become available in your chats.

Claude Code

claude mcp add --transport http turbodato https://app.turbodato.com/api/mcp

Then run /mcp inside Claude Code and choose Authenticate to complete the sign-in in your browser.

What Claude can see

The connection acts as you, with the scope turbodato:read. Claude sees exactly the dashboards your Turbodato user can see — nothing more:

  • A member sees only the dashboards they are linked to.
  • Organization owners and admins see every dashboard in their organization.

Access is re-checked on every call, so if an admin removes your access to a dashboard, Claude loses it too. Access tokens last one hour and refresh tokens 30 days; when a user is removed from Turbodato, their connector stops working within the hour.

Tools

All tools are read-only. Every tool except list_clients takes a clientId (a dashboard), which Claude gets from list_clients.

list_clients

Lists the dashboards you have access to, with their id and name. Claude calls it first.

get_semaphore

Traffic-light summary of your price position: how many products are priced above, at or below the competition, with percentages. Red means a competitor is cheaper than your site; green means competitors are more expensive. The cheapest way to get an overall read. Accepts the common filters below.

get_data

The detailed competitive price matrix: each of your products with the prices observed per retailer and seller. Paginated (up to 100 rows per page). Besides the common filters it accepts semaphore (red, yellow, green), order_by (priceASC, priceDESC, discountASC, discountDESC), page and limit. For multi-unit packs it returns per-unit prices, and for brands with a suggested retail price it flags offers below it.

get_suggested_price

Suggested-retail-price (RRP / MAP) compliance: how many products and offers are below the brand's suggested price, plus the offending offers, worst first (up to 500). Only for dashboards that track a suggested price.

get_filters

The valid filter values for a dashboard: categories, brands, sellers and sites.

get_dates

The dates that have price observations, to use as the date filter.

export_data

Bulk export of the price matrix as JSON, capped at 500 products, for analysis over many products at once.

Common filters

  • brand, category, site, seller — exact values from get_filters.
  • text — free-text search over product name, EAN, SKU and brand.
  • date — observation date, YYYY-MM-DD, from get_dates.
  • favorites — only the products you starred in the dashboard.

Limits

  • 60 tool calls per minute per user. Past that, the tool answers with a message asking to wait, and Claude retries on its own.
  • Up to 100 rows per get_data page and 500 products per export_data call, to keep results within what the model can read.

Disconnecting

In Claude, go to Settings → Connectors, open Turbodato and choose Disconnect. That deletes the tokens held by Claude. In Claude Code, run claude mcp remove turbodato.

Troubleshooting

  • “No access to that clientId.” The dashboard isn't linked to your user. Ask your organization admin for access, then ask Claude to list your dashboards again.
  • Claude says there are no dashboards. Your user has no dashboard assigned yet; contact your admin or Turbodato support.
  • get_suggested_price returns an error. That dashboard doesn't track a suggested retail price. Use get_semaphore or get_data instead.
  • The connector asks you to sign in again. Refresh tokens last 30 days; after that, reconnect from Settings → Connectors.

Privacy and security

See the MCP connector privacy policy for what the connector receives, what Turbodato logs and how long it's kept.

Support

Write to santiago@turbodato.com. We answer in English and Spanish.