Quickstart.
Connect any MCP-capable AI host to AdTAO in a few minutes, then grab the skills package so your agent knows the best way to use it.
Step 01 · ~30 seconds
Get your API key
- 01 Log in to your AdTAO account.
- 02 Go to Settings → Security & Privacy → API Access.
- 03 Click Create Key. Copy it — it looks like
adtao_…and you'll only see it once.
Keep it secret. Treat it like a password.
Free users: creating a key needs a paid plan. Free users can still use AdTAO read-only via Claude Desktop sign-in — see access for what each plan's level includes.
Step 02 · ~2 minutes
Connect your host
Pick your host. The endpoint is always https://mcp.adtao.io/mcp.
Claude Code (CLI)
One line
claude mcp add --transport http adtao https://mcp.adtao.io/mcp \
--header "Authorization: Bearer YOUR_API_KEY" Claude Desktop
MCP config JSON
Add to your Claude Desktop MCP config and restart Claude:
{
"mcpServers": {
"adtao": {
"transport": "http",
"url": "https://mcp.adtao.io/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
} Cursor
.cursor/mcp.json
Add to .cursor/mcp.json:
{
"mcpServers": {
"adtao": {
"url": "https://mcp.adtao.io/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Replace YOUR_API_KEY with the key from step 1. Never commit the real key to source control.
Step 03 · ~10 seconds
Verify it's connected
Ask your agent:
"List my accessible Google Ads accounts."
If you see your accounts, you're connected. If you see an auth error, re-check the Authorization header.
Step 04 · ~1 minute
Get the skills package
The skills package is a small set of ready-made playbooks that teach your agent the best way to use AdTAO — weekly reporting, health scans, budget checks, and safe bulk approvals.
The skills package is in private beta and ships with your AdTAO subscription. Get in touch for access during the v1.0 rollout. Once loaded, ask:
"Run my weekly portfolio report."
and the agent will follow the weekly-portfolio-report skill end to end.
What's in the package
4 skills
-
weekly-portfolio-reportFull portfolio read: headline, per-account tiering, alerts, recommended actions.
-
account-health-scanRuns the 253-archetype scan on one account, summarises the scored issues.
-
budget-pacing-checkFlags every account that's over- or under-pacing.
-
safe-bulk-approvalWalks the pending approval queue with you and executes what you approve.
Skills ship incrementally — more are added with each release. See changelog.
Step 05 · now you're flying
Try a real workflow
Once the package is loaded, good first prompts:
- "Give me the read on all my accounts this week."
- "Scan account X for problems and show me the dollar impact."
- "Which of my accounts are overspending right now?"
- "Show me what's pending approval, and let's go through it."
Troubleshooting
If something's off
- Auth error
- Re-check the Bearer token; regenerate the key if needed.
- "Account still syncing"
- A newly connected account takes a short while to ingest; the agent will tell you when it's ready (or use subscribe_to_sync_complete).
- Tool not found
- Make sure your host finished loading the MCP server; restart the host after editing config.
Continue exploring