👉 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
Step 1: Add the connector in your AI Assistant. We're using Claude as an example
Go to https://claude.ai and open Settings.
Click Connectors, then click + and select Custom connector.
Give it a name (for example, "DatAds") and enter this URL: https://public.api.datads.io/mcp
Click Add, then click Connect. You will be redirected to DatAds to authorize the connection.
Step 2: Get your API key from DatAds
You need an API key to authorize Claude's access to your data.
In DatAds, go to Settings > Clients.
Find the client you want to connect and click Manage.
Scroll to the API key section. If you don't have a key yet, click Add, then Generate.
Copy the API key immediately and store it somewhere safe.
⚠️ Important: Your API key is only shown once. If you lose it, you will need to delete it and generate a new one.
💡 Tip: To give Claude access to all your clients at once, use the All Clients Client.
Step 3: Authorize the connection
Paste the API key into the authorization field and click Authorize. Once successful, you are redirected back to Claude and the DatAds connector is active.
To confirm, click + in Claude and check that the DatAds connector appears under Connectors.
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.
💡Pro Tip: this includes your third party attribution data. Find out which attribution tools we currently support here.
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. 💬