⚠️ Authentication update — action required
We have updated the authentication method and MCP server endpoint. The old endpoint (https://public.api.datads.io/mcp) has been deactivated. Please follow the updated setup instructions below to migrate your connection.
👉 For the full technical reference, read our documentation.
What is the DatAds API and MCP server?
The DatAds API gives you direct access to your ad performance data outside of the DatAds interface. The MCP server is built on top of it and lets AI assistants connect to DatAds and query your data in real time.
In plain terms: once connected, you can ask Claude "what are my top performing ads this week?" and get an answer drawn from your actual data, without opening a report or exporting anything.
❗Early access: The DatAds API and MCP server launched in May 2026. This is the first version. Available tools and capabilities will expand with each release — check back for updates.
What you can do with it
The current version gives your AI Assistants access to three tools:
Breakdowns: break down ad performance by dimension, such as creative, campaign, ad account, or ad-level attributes like headline, description, or name
Charts: pull visual performance data for your ad metrics
Stats: retrieve top-level performance numbers for any time range
You can use these to ask an AI natural-language questions about your ad account, generate quick summaries, or combine DatAds data with other connected tools in a single conversation.
👉 For the full technical reference, read our documentation.
How to set up the MCP server in Claude
You can now authenticate using the same credentials you use for the DatAds dashboard. No separate API key is needed.
How to connect
Step 1: Remove any old connections
Go to "Settings" → "Connections" and remove any existing DatAds connections before proceeding.
Step 2: Add a custom connection
Click "Add custom connection" and enter the URL, Client ID, and password found in the dashboard under the MCP tab (bottom left of the sidebar).
Step 3: Test your connection
Open Claude and ask: "List my accessible clients in DatAds." A successful response confirms the connection is working.
MCP capabilities
With the updated integration, you can:
Access client data directly — your AI assistant can access any client you have permission to view in the dashboard. Just mention the client name and Claude will query the right data automatically.
More flexible metadata queries — search for ads by name or headline, list ad accounts filtered by provider, and browse ad groups and ad sets with more flexibility.
Breakdowns, charts, and stats — break down ad performance by dimension, pull visual performance data, and retrieve top-level numbers for any time range.
💡 Pro Tip: this includes your third party attribution data. Find out which attribution tools we currently support here.
Using DatAds in Claude
Once connected, ask questions about your ad performance directly in any Claude conversation:
- "What are my top performing ads this month?"
- "Break down performance by creative format"
- "Show me stats for the last 30 days"
Claude will call the DatAds tools automatically, pull the relevant data, and summarize it for you.
If you have any questions or would like to share feedback, feel free to reach out to us anytime via the chat widget in the bottom right corner of your dashboard. 💬