Connecting to the DataDome MCP Server

The DataDome MCP (Model Context Protocol) Server lets you connect your AI assistant, such as Claude Code, directly to your DataDome account. Once connected, you can ask natural-language questions about your Trend Reports (traffic analytics, bot activity, threat trends, etc.) without leaving your AI assistant.

This guide walks you through connecting the DataDome MCP Server to an AI assistant (using Claude Code as example), and how to authorize the connection using your DataDome Dashboard credentials. The same steps can be adapted to connect any other MCP-compatible client or tool.

What you'll need

• An active DataDome account with access to the DataDome Dashboard
• Permissions to view Trend Reports in your DataDome organization
• An MCP-compatible AI assistant or client installed and configured, for example Claude Code
• The DataDome MCP Server URL: https://mcp.datadome.co/mcp

What you can do once connected

Once the connection is authorized, you can ask your AI assistant things like:

• "Summarize this week's bot traffic trends from DataDome."
• "Show me the top 3 threat type in the last 60 days."
• "Compare this month's traffic type to last month's."

The assistant retrieves this data live from your DataDome Trend Reports via the MCP Server, so answers always reflect your current dashboard data.

Example: Connecting Claude Code to DataDome's MCP Server

1. Open a terminal in the project where you want to use DataDome's Trend Reports.

2. Run the following command:

   Bash

   claude mcp add --transport http [connection name] https://mcp.datadome.co/mcp --scope [selected scope]

   • --transport http: tells Claude Code this is a remote HTTP-based MCP server.
   • [connection name]: choose a name to identify this connection locally (e.g. datadome-trends-report).
   • --scope [selected scope]: choose where this connection is available:
     • local: only available to you, on this machine, for this project
     • project: available to anyone working in this project
     • user: available to you across all your projects, on this machine

   Example:

   Bash

   claude mcp add --transport http datadome-trends-report https://mcp.datadome.co/mcp --scope project

3. Claude Code will initiate the connection to the DataDome MCP Server. Since this server requires authorization, Claude Code will open a browser window (or provide a link if running headless) to complete authentication.

4. Log in with your DataDome Dashboard credentials (the same email and password you use at app.datadome.co). If your account uses SSO, follow your organization's usual sign-in flow.

5. Once you're successfully logged in, you'll be redirected back automatically and the connection will be authorized.

6. Return to your terminal, Claude Code will confirm the server is connected.

7. You can verify the connection at any time with:

   Bash

   claude mcp list

You can now start a session in Claude Code and ask questions about your DataDome Trend Reports. Claude will call the connection you named automatically whenever relevant.

To remove the connection later, run:

Bash

claude mcp remove [connection name]

Authorizing the connection: what to expect

The authorization steps works the same way no matter the assistant:

1. The connection triggers a secure DataDome login page (app.datadome.co) to open in your browser.
2. You sign in using your existing DataDome Dashboard credentials.
3. Once logged in successfully, you're redirected back to your AI assistant and the connection is authorized automatically, no separate approval screen is needed.
4. An access token is issued to your AI assistant; DataDome never shares your password with your AI assistant.
5. To revoke access, remove the connector from your AI assistant, for example using claude mcp remove [connection name] for Claude Code. There is currently no connected-apps management option in the DataDome Dashboard itself.

FAQ

Does DataDome see my AI assistant conversations?
No. The MCP Server only responds to specific data requests made by the assistant; it does not have visibility into your broader chat history.

I have multiple DataDome workspaces. How do I target a specific one?
When asking a question, include the name of the workspace you want to query (e.g. "Show me last week's bot traffic trends for the Acme EU workspace"). The assistant uses the workspace's name to route the request to the correct DataDome workspace.

Why can’t I query data from certain workspaces?
The MCP can only query data from the workspaces your personal DataDome account has access to. Access is not automatically granted to all workspaces belonging to your company.
For example, if your company has access to workspaces X, Y, and Z, but your DataDome Dashboard account only has access to workspace Y, you will not be able to query data from workspaces X or Z through the MCP.
To query data from those workspaces, your company must invite your DataDome account to workspaces X and Z. Once you have been granted access, the MCP will be able to query the data available in those workspaces, subject to your permissions.

Is there a screen where I approve what data the assistant can access?
No, once you log in successfully with your DataDome Dashboard credentials, the connection is authorized automatically. Access is scoped to Trend Reports based on your existing DataDome user permissions.

Can I disconnect at any time?
Yes, you have total control. For example for Claude Code, use the command claude mcp remove [connection name] to revoke the access. Each AI assistant should have similar commands/actions. Access cannot currently be managed from the DataDome Dashboard.

How can I get results based on a specific timezone?
If no timezone is specified, the MCP may interpret the request using its default timezone (UTC+0), which may not match your local time. For consistent and accurate results, always include the relevant timezone in your prompt.