dcluttr MCP server

Overview#

Once connected, your assistant can look up your dcluttr data whenever a question needs it. You ask in plain English; it finds the right dataset, runs the query and explains the answer.

Your AI app
Claude, Codex, Cursor…
dcluttr MCP server
mcp.dcluttr.ai
Your dcluttr data
Only brands you approve

What you can ask

Availability: on-shelf availability (OSA) by SKU and location, and what changed.
Sales and offtake: units and value by SKU, category and platform over any date range.
Ads: spend, attributed sales and ROAS by campaign.
Pricing: selling prices and how you compare with competitors.

Before you start#

A dcluttr account with access to at least one brand.
MCP access turned on for your account. If it isn't, your dcluttr admin or our support team can enable it.
An AI app that supports remote MCP servers with sign-in: Claude (web and desktop, any plan), Claude Code, Codex, Cursor or VS Code.

Signed in to dcluttr already?

Open your profile and choose MCP for a guided setup. Open guided setup

Connect your AI app#

Pick the app you use. Every option ends with the same dcluttr sign-in.

From Claude's directory

1
Open dcluttr in Claude's directory
Add to Claude
2
Press Connect
A dcluttr page opens. Sign in if you aren't already, tick the brands to share and press Allow.
3
Turn it on in a chat
In a conversation, select +›Connectors and turn on dcluttr.

As a custom connector

1
Open Claude's connector settings
In Claude, go to Customize›Connectors and select Add custom connector.
Open Claude connectors
2
Name it dcluttr and paste the server URL
Server URL
https://mcp.dcluttr.ai/mcp
3
Select Add, then Connect
A dcluttr page opens. Sign in if you aren't already, tick the brands to share and press Allow.
4
Turn it on in a chat
In a conversation, select +›Connectors and turn on dcluttr.

On a Claude Team or Enterprise plan?

A Claude Owner adds the connector once for the workspace, in Organization settings›Connectors›Add›Custom, using the same server URL. Everyone then presses Connect under Customize›Connectors and signs in with their own dcluttr account.

Connectors you add on claude.ai also appear in the Claude desktop app.

1
Add the server
in your terminal
claude mcp add --transport http dcluttr https://mcp.dcluttr.ai/mcp
Add --scope user to make it available in every project.
2
Sign in
Start Claude Code, run /mcp, select dcluttr and choose Authenticate. Your browser opens a dcluttr page: sign in if needed, tick the brands to share and press Allow.
3
Ask a question
Claude Code now uses dcluttr whenever a question needs your data.

1
Add the server
in your terminal
codex mcp add dcluttr --url https://mcp.dcluttr.ai/mcp
2
Sign in
in your terminal
codex mcp login dcluttr
Your browser opens a dcluttr page: sign in if needed, tick the brands to share and press Allow.
3
Ask a question
The ChatGPT desktop app, Codex CLI and Codex IDE extension share this setup, so you only do it once per computer.

Prefer editing the config file?

Add this to ~/.codex/config.toml, then run codex mcp login dcluttr.

config.toml

[mcp_servers.dcluttr]
url = "https://mcp.dcluttr.ai/mcp"

1
Install in Cursor
Add to Cursor
2
Sign in
The first time Cursor connects, it asks you to sign in. A dcluttr page opens. Sign in if you aren't already, tick the brands to share and press Allow.

Or configure it by hand

Add this to ~/.cursor/mcp.json.

mcp.json

{
  "mcpServers": {
    "dcluttr": {
      "url": "https://mcp.dcluttr.ai/mcp"
    }
  }
}

1
Install in VS Code
Add to VS Code
2
Sign in
VS Code asks you to sign in when the server starts. A dcluttr page opens. Sign in if you aren't already, tick the brands to share and press Allow. Use it from Copilot Chat in agent mode.

Or configure it by hand

Add this to .vscode/mcp.json in your workspace.

mcp.json

{
  "servers": {
    "dcluttr": {
      "type": "http",
      "url": "https://mcp.dcluttr.ai/mcp"
    }
  }
}

Any app that supports remote MCP servers with sign-in (OAuth) works. Add dcluttr as a remote HTTP server, not a local command, using this URL:

Server URL

streamable HTTP · OAuth

https://mcp.dcluttr.ai/mcp

When the app connects, a dcluttr page opens. Sign in if you aren't already, tick the brands to share and press Allow. dcluttr doesn't issue API keys, so apps that only accept a key can't connect.

1
Your app opens a dcluttr page
If you're signed in to dcluttr in that browser, you go straight to the approval screen. If not, sign in first.
2
Choose the brands to share
You see the brands your dcluttr account can access. Tick the ones this app may query.
3
Press Allow
You're sent back to your app, connected. Your password never leaves dcluttr: the app gets a key that works only for this connection.

What the connection can do

Read only. It looks things up. It can't change budgets, prices, campaigns or anything else in dcluttr.
Only the brands you approved, and only what your dcluttr role can already see.
Stays connected until you disconnect it. Changing or resetting your dcluttr password disconnects every app, and a connection unused for 90 days expires.
Switch brands by asking. Say “switch to <brand name>” to change which approved brand questions use.

Tools#

These are the tools your assistant can call. All of them read data; switch_brand only changes which approved brand this connection uses by default.

Tool	What it does	Access
Find the right data
`search_datasets` Search datasets	Finds the datasets that can answer a question, by keyword across names, descriptions, metrics and columns.	Read-only
`search_metrics` Search metrics	Finds a metric, such as weighted OSA or ad spend, across every dataset and shows which platforms have it.	Read-only
`list_datasets` List datasets	Lists every dataset with its grain and a one-line description.	Read-only
`list_metrics` List metrics for a dataset	Lists the metrics available in one dataset.	Read-only
`get_dataset_context` Get dataset context	Returns a dataset's columns, metrics, segments and example questions, so queries are written correctly.	Read-only
Answer questions
`ask_data_question` Ask data question	Turns a plain-English question into a query on the right dataset and runs it, within your approved brands.	Read-only
`run_semantic_query` Run semantic query	Runs a structured query (measures, dimensions, filters and a date range) with guardrails on size and scope.	Read-only
Your connection
`whoami` Who am I	Shows the dcluttr account this connection uses, the active brand and every brand it may query.	Read-only
`switch_brand` Switch active brand	Changes which of your approved brands later questions use by default. Changes no dcluttr data.	Connection setting

Example prompts#

Ask the way you would ask an analyst. Name the platform, the period and the metric when you can.

“Why did Zepto availability drop last week for my top 10 SKUs?”
A week-over-week OSA comparison by SKU, with the SKUs that fell the most called out.
Usessearch_datasetsask_data_question
“Show Blinkit offtake by SKU for September, with OSA alongside.”
A table of offtake and on-shelf availability for each SKU for the month.
Usessearch_metricsrun_semantic_query
“Which Instamart campaigns had ROAS below 2x in the last 14 days?”
The campaigns under 2x ROAS, with their spend and attributed sales.
Usessearch_datasetsask_data_question
“Compare our average selling price with competitors on Blinkit this month.”
Your average selling price next to competing brands in the same categories.
Usessearch_metricsask_data_question

Manage or disconnect#

In dcluttr

Open your profile and choose MCP to see your connected apps and disconnect any of them. Org admins see everyone in the organisation. Disconnecting stops access straight away.

In Claude

Go to Customize›Connectors, open dcluttr and disconnect it.

Claude Code

terminal

claude mcp remove dcluttr

Codex

terminal

codex mcp remove dcluttr

Data and privacy#

What it can read: data for the brands you approved, limited to what your dcluttr role allows.
What it never gets: your dcluttr password, your chat history, other connectors or your files. Only the requests your assistant sends to dcluttr reach us.
What we log: each tool request and a capped copy of its result, with your dcluttr user id, to run, debug and improve the service. These logs are stored with a third-party observability provider.
Plain-English questions: to turn a question into a query, the question and our dataset descriptions (not your data) may be sent to an AI model provider such as OpenAI.

Read the MCP section of our privacy policy.

Troubleshooting#

No sign-in window opened

Your browser may have blocked the pop-up. Allow pop-ups for claude.ai (or your app) and press Connect again. In Claude Code, run /mcp, pick dcluttr and choose Authenticate. In Codex, run codex mcp login dcluttr.

It says MCP access isn't enabled for my account

MCP access is switched on per dcluttr account. Ask your dcluttr admin to enable it, or contact support with the email you sign in with.

I'm asked to sign in again

A connection ends when someone disconnects it in dcluttr, when you change or reset your dcluttr password, or after 90 days without use. Connect again from your app; if you're signed in to dcluttr it's one click.

New tools don't show up

Start a new chat. In Claude, open Customize › Connectors › dcluttr and choose Refresh tools list. In Claude Code and Codex, start a new session.

My app can't reach mcp.dcluttr.ai

Company networks sometimes block new domains. Ask your IT team to allow https://mcp.dcluttr.ai.

Answers are for the wrong brand

Ask the assistant which brand it's using, then say “switch to <brand name>”. To add a brand you didn't approve, disconnect and connect again, and tick it on the approval screen.

Support#

Email team@dcluttr.ai

Tell us the app you use, roughly when it happened, what you asked, and the email you sign in to dcluttr with. Please don't send passwords or tokens.

Server: https://mcp.dcluttr.ai/mcp

Use your dcluttr data in Claude, Codex and other AI apps

Overview#

What you can ask

Before you start#

Connect your AI app#

From Claude's directory

As a custom connector

Prefer editing the config file?

Or configure it by hand

Or configure it by hand

Sign in and permissions#

What the connection can do

Tools#

Example prompts#

Manage or disconnect#

In dcluttr

In Claude

Data and privacy#

Troubleshooting#

Support#