Quickstart

Get Claude Code talking to Ad Command's 24 tools in three steps.

1. Get an API key

If you have an active Ad Command subscription, one of two things has already happened:

Option A — auto-issued via email. When your subscription started, you received an email titled "Your Ad Command API key is ready" containing your cleartext key (ac_live_...) and a paste-ready config snippet. Save this email. The cleartext key is shown only once.

Option B — mint a key from Settings. Open app.adcommand.io/settings, scroll to API Keys (MCP), click + New Key, name it (e.g. "AI Media Buyer — office Mac"), and copy the cleartext key + config snippet from the dialog.

WARNING

The cleartext key is shown once. If you lose it, revoke and create a new one — there's no way to recover the old cleartext.

2. Add to Claude Code

Open ~/.claude.json (user-level, recommended) or your project's .mcp.json (committed, shared with team) and add an entry under mcpServers:

{
  "mcpServers": {
    "ad-command": {
      "type": "http",
      "url": "https://kkwbfbsokgefebizzkpt.supabase.co/functions/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer ac_live_your_key_here"
      }
    }
  }
}

Don't commit cleartext keys

Project-level .mcp.json files are typically committed to git. Use ~/.claude.json (user-level home directory, not in any repo) to keep keys out of source control.

3. Restart Claude Code & verify

# In a fresh Claude Code session:
/mcp

You should see:

ad-command          ✓ connected         24 tools

If you see ✗ disconnected, the most likely cause is a typo in the auth header. Re-check by running:

cat ~/.claude.json | python3 -c \
  "import sys,json; print(json.load(sys.stdin)['mcpServers']['ad-command'])"

4. Try it

Ask Claude Code things like:

Cheap / instant tests (free or low cost)

• "List my Ad Command clients." — calls list_clients, free, ~1s
• "Show my Ad Command credit balance." — calls get_credit_balance, free, ~0.5s

Real-work tests

• "Use Ad Command to plan a creative strategy for a $97/mo project-management SaaS targeting solo consultants. Cold LinkedIn traffic. Budget 1000 credits." — calls decide_creative_strategy, 30 cr, ~30s. Returns format mix + angles + warnings.
• "Use Ad Command to generate ad copy for [your offer]." — calls generate_ad_copy, 20 cr, ~10s. Returns 5 variations.

The killer demo

• "Use Ad Command to plan AND generate a complete campaign for [your offer]. Use the strategist to decide format mix, then run the campaign." — chains decide_creative_strategy → generate_complete_campaign. Generates everything in parallel. Cost: depends on manifest, typically 200–500 cr.

Common issues

Symptom	Most likely cause
/mcp shows ad-command disconnected	Auth header typo. Re-paste from the email or Settings dialog.
Tool calls return 401 Invalid or revoked key	Key was revoked from Settings, or copied incorrectly. Mint a fresh one.
Tool calls return 429 Rate limit exceeded	More than 60 calls/minute on the same key. Wait 60s or split into multiple keys.
Tool 'X' requires 'agency' tier or higher	Your subscription tier doesn't include this tool. See pricing →.
429 Daily credit cap reached	Hit the per-day spend ceiling (1500/5000/15000 for Starter/Pro/Agency). Rolls off after 24h.
Anthropic / OpenAI errors deep in a tool	Provider-side outage or rate limit — the tool refunded your credits. Retry.

Full error reference →

What's next

• Browse the tool catalog to see what each of the 24 tools does, with cost + tier info
• Manage keys — create more, revoke compromised ones, see last-used timestamps
• Errors & troubleshooting — full table of error codes you might encounter