Skip to main content

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

  1. 01 Log in to your AdTAO account.
  2. 02 Go to Settings → Security & Privacy → API Access.
  3. 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-report

    Full portfolio read: headline, per-account tiering, alerts, recommended actions.

  • account-health-scan

    Runs the 253-archetype scan on one account, summarises the scored issues.

  • budget-pacing-check

    Flags every account that's over- or under-pacing.

  • safe-bulk-approval

    Walks 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

Continue exploring