adako-mcp

# Adako — careful ad ops for AI agents

**アダコ** · [adako.ai](https://adako.ai)

Adako is an MCP server and REST API that connects Claude, ChatGPT, Cursor and other assistants to
Google Ads, Meta Ads, ChatGPT Ads, TikTok Ads and LinkedIn Ads.

```
https://adako.ai/mcp
```

Ask "how did my campaigns do last month?" and get an answer from the live account, in the account's
own currency. Ask "raise that budget to 40 a day" and get a proposal you approve before anything
moves. Created campaigns are always paused.

This repository holds the public pieces: the Agent Skills, per-client configuration, one-file
installers, a Claude Code plugin, and the MCP Registry entry. The server itself is hosted.

---

## What it can do

231 tools across five platforms, plus Adako's own.

| Platform     | Tools | What they cover                                                                                                                                                                 |
| ------------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Google Ads   | 70    | Search and Performance Max, keywords and search terms, budgets and bid strategies, assets and extensions, conversion actions, labels, schedules, geo, hourly and device reports |
| Meta Ads     | 43    | Campaigns, ad sets and ads, image, video, carousel and app-install launches, audiences and placements, pixels, lead forms, creative fatigue                                     |
| LinkedIn Ads | 34    | Campaign groups and campaigns, image, video, carousel and text ads, B2B targeting, audience forecasts, conversion rules, engagement metrics                                     |
| TikTok Ads   | 30    | Campaigns, ad groups and in-feed video ads, Spark Ads, video metrics, identities, pixels, creative fatigue                                                                      |
| ChatGPT Ads  | 23    | Chat card campaigns end to end, account limits, pixels, review verdicts                                                                                                         |
| Adako        | 31    | Connections and usage, tool discovery, proposals, diagnostics, monitors, briefs and reports                                                                                     |

Your client does not see 231 entries. It sees 15 tools callable by name plus 7 routers
(`google_ads`, `meta_ads`, `chatgpt_ads`, `tiktok_ads`, `linkedin_ads`, `monitoring`,
`diagnostics`), and reaches the rest with
`google_ads(action="execute", tool_name="…", arguments={...})`. `search_tools` finds the right one
from your own wording, and it is free. See [adako.ai/docs/routers](https://adako.ai/docs/routers).

TikTok Ads and LinkedIn Ads are available on request; write to support@adako.ai if you do not see
them on the Connections page.

---

## The safety model

Adako is built so that an assistant can be useful without being dangerous.

| Rule                           | What it means                                                                                                                                              |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Reads run immediately          | Performance, structure, search terms, audiences. Nothing to approve.                                                                                       |
| Every write becomes a proposal | You see the object, the before and after values, and the daily cost before anything is sent.                                                               |
| Approval is yours              | Confirm in the chat, or leave proposals in an inbox and approve them at [adako.ai/approvals](https://adako.ai/approvals). Proposals expire after 48 hours. |
| Created objects are paused     | Every campaign, ad set and ad Adako creates starts paused. You enable it yourself.                                                                         |
| Almost nothing deletes         | Eight tools remove something and each needs an explicit confirmation flag. Pause never routes to a delete.                                                 |
| Executed once                  | Each approved proposal carries an idempotency key. Approving twice reports the first result and repeats nothing.                                           |
| Read-back on every write       | The change is confirmed by reading the object back from the platform, not by trusting the response.                                                        |
| Tokens stay server-side        | Your platform tokens are held encrypted by Adako and are never forwarded to the AI client.                                                                 |

Details: [adako.ai/docs/safety](https://adako.ai/docs/safety).

---

## Install — five minutes

Two ways to authenticate:

- **OAuth** — the client opens a browser, you sign in to Adako once. Preferred everywhere it works.
- **API key** — create one at [adako.ai/keys](https://adako.ai/keys), send it as
  `Authorization: Bearer ak_live_…`. Use it for clients that read a static config file.

Pick your client.

### Claude.ai (custom connector)

Pro and Max: **Settings → Connectors → Add custom connector**. Paste the URL, click **Add**, then
**Connect** and sign in.

Team and Enterprise: an owner adds it first under **Organization settings → Connectors → Add**, hovers
**Custom**, chooses **Web**, and pastes the URL. Members then connect it from their own
**Settings → Connectors**.

```
https://adako.ai/mcp
```

The number of custom connectors you can add depends on your Claude plan.

### Claude Desktop

Same **Connectors** settings as Claude.ai — add the custom connector with the URL above, then sign in
when prompted. Desktop shares your Claude account, so a connector added on the web is available here
too. Full guide: [`clients/claude-desktop.md`](clients/claude-desktop.md).

### Claude Code

```bash
claude mcp add --transport http adako https://adako.ai/mcp
```

Then run `/mcp` inside a session and pick **adako** to sign in through the browser.

Add it once for every project with `--scope user`:

```bash
claude mcp add --transport http adako https://adako.ai/mcp --scope user
```

API-key variant, no browser step:

```bash
claude mcp add --transport http adako https://adako.ai/mcp \
  --header "Authorization: Bearer ak_live_your_key"
```

There is also a plugin that installs the server, the skills, a setup command and an operator agent in
one step:

```
/plugin marketplace add ruslan2027/adako-mcp
/plugin install adako@adako
/adako-setup
```

See [`clients/claude-code.md`](clients/claude-code.md) and [`plugin/`](plugin).

### ChatGPT (developer mode)

1. Turn on **Developer mode** under **Settings → Security & login**, then
   [open ChatGPT Plugins](https://chatgpt.com/plugins#settings/Connectors?create-connector=true).
2. Click **+**. Enter `Adako` as the connection name and `https://adako.ai/mcp` as the MCP server URL.
   Add a short description, choose the public endpoint connection option, and click **Create**.
3. Complete authorization if prompted.
4. Start a new conversation, open the tools menu, and select Adako.

Full guide: [`clients/chatgpt.md`](clients/chatgpt.md).

### Cursor

One command, idempotent, and it leaves your other servers alone:

```bash
node install/cursor.mjs            # ~/.cursor/mcp.json
node install/cursor.mjs --project  # .cursor/mcp.json in this repository
```

Or write the file yourself:

```json
{
  "mcpServers": {
    "adako": {
      "url": "https://adako.ai/mcp"
    }
  }
}
```

Full file: [`clients/cursor/mcp.json`](clients/cursor/mcp.json). Guide:
[`clients/cursor.md`](clients/cursor.md).

### Codex CLI

```bash
codex mcp add adako --url https://adako.ai/mcp
codex mcp login adako
```

Or run the installer, which rewrites one table in `~/.codex/config.toml` and leaves the rest of the
file untouched:

```bash
node install/codex.mjs            # API key from $ADAKO_API_KEY
node install/codex.mjs --oauth    # sign in with codex mcp login instead
```

Full file: [`clients/codex/config.toml`](clients/codex/config.toml). Guide:
[`clients/codex.md`](clients/codex.md).

### Windsurf

```bash
node install/windsurf.mjs
```

Or add the block by hand to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "adako": {
      "serverUrl": "https://adako.ai/mcp"
    }
  }
}
```

Full file: [`clients/windsurf/mcp_config.json`](clients/windsurf/mcp_config.json). Guide:
[`clients/windsurf.md`](clients/windsurf.md). **Untested** — the configuration follows the documented
format, but Adako has not been verified in Windsurf yet.

### Gemini CLI

`~/.gemini/settings.json`:

```json
{
  "mcpServers": {
    "adako": {
      "httpUrl": "https://adako.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${ADAKO_API_KEY}"
      }
    }
  }
}
```

An extension manifest is in [`clients/gemini-cli/gemini-extension.json`](clients/gemini-cli/gemini-extension.json).
Guide: [`clients/gemini-cli.md`](clients/gemini-cli.md). **Untested** — the extension packaging has
not been run end to end against Adako yet.

### VS Code (Copilot)

`.vscode/mcp.json` in a workspace, or your user `mcp.json`:

```json
{
  "servers": {
    "adako": {
      "type": "http",
      "url": "https://adako.ai/mcp"
    }
  }
}
```

VS Code handles the OAuth flow. Full file with the API-key variant:
[`clients/vscode/mcp.json`](clients/vscode/mcp.json). Guide: [`clients/vscode.md`](clients/vscode.md).
**Untested** — configuration follows the documented format.

### Perplexity

Add Adako as a connector in the desktop app: **Settings → Connectors**, then the URL above. Guide:
[`clients/perplexity.md`](clients/perplexity.md). **Untested** — conne