Quickstart.

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 mcp add --transport http adtao https://mcp.adtao.io/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

{
  "mcpServers": {
    "adtao": {
      "transport": "http",
      "url": "https://mcp.adtao.io/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

{
  "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.

"Run my weekly portfolio report."

and the agent will follow the weekly-portfolio-report skill end to end.

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: budget pacing and impression share."
• → "Scan account X for wasted spend in the search terms report and any learning period risk."
• → "Which accounts are off their budget pacing right now?"
• → "Build me a negative keywords list from my search terms report, and show me what it recovers."