# Adsroid MCP

One MCP server. Every major ad platform. Any AI assistant.

Adsroid MCP connects Claude, ChatGPT, Cursor, or any MCP-compatible client directly to your advertising and marketing accounts — Google Ads, Meta Ads, Microsoft Ads, TikTok Ads, LinkedIn Ads, Google Search Console, Google Analytics 4, and HubSpot — through a single endpoint.

Instead of switching between dashboards, your AI assistant reads live account data, proposes changes, and executes them (with your confirmation) directly inside the conversation.

```
https://mcp.adsroid.com/mcp
```

## What is Adsroid MCP?

Adsroid MCP is the Model Context Protocol interface to the [Adsroid](https://adsroid.com) advertising platform. It exposes Adsroid's analysis, management, and campaign-building capabilities as MCP tools, so any MCP client can operate on a user's real ad accounts — reading performance data, adjusting budgets and bids, and building campaigns from scratch — through natural language.

This repository is documentation only. The Adsroid MCP server itself is closed-source and runs as a hosted service; there is nothing to install or self-host. This repo exists to explain how the MCP works, what it can do, and how to connect it to your AI assistant of choice.

## Why a single MCP for everything

Most MCP servers wrap one platform, one account. Real media buyers and agencies don't work that way — they manage multiple clients across multiple channels in the same session.

- **One endpoint, every platform.** No separate server per ad platform, no re-authentication per account.
- **True multi-account.** Your assistant can work across every client/project tied to your organization in the same conversation, without mixing data between them.
- **OAuth in one click.** Standard OAuth 2.0 authorization code flow with PKCE and Dynamic Client Registration — no manual token management.
- **Read and write from day one.** Beyond analysis, Adsroid MCP can create and modify live campaigns, ad groups, ads, budgets, and targeting.
- **Zero data retention.** Every tool call is a real-time round trip to the official platform APIs. Nothing is cached or stored server-side.

## Platforms

| Platform | Capabilities |
|---|---|
| Google Ads | Analyze · Manage · Build · Test |
| Meta Ads | Analyze · Manage · Build · Test |
| Google Search Console | Analyze |
| Google Analytics 4 | Analyze |
| Ad Radar (competitive intelligence) | Analyze |
| Microsoft Ads | Coming soon |
| TikTok Ads | Coming soon |
| LinkedIn Ads | Coming soon |

See [tools-overview.md](./tools-overview.md) for what each capability category covers.

## Quick start

1. **Get your API key.** Sign up at [app.adsroid.com](https://app.adsroid.com/register) and generate an API key from Settings.
2. **Connect your MCP client.** In Claude.ai, go to Settings → Connectors and add:
   ```
   https://mcp.adsroid.com/mcp
   ```
3. **Sign in.** Your client opens the Adsroid authorization page. Enter your API key and organization ID — that's it, no tokens to copy around.
4. **Start talking to your accounts.** Ask your assistant to audit a campaign, pull performance metrics, analyze search terms, or build a new campaign end to end.

Full walkthrough: [guides/getting-started.md](./guides/getting-started.md)

## Example

```
You: Give me a performance overview of all my campaigns this month,
     and flag any that are underperforming.

Assistant → Adsroid MCP: retrieves live account metrics

Assistant: Two campaigns are flagging. "Generic_Keywords" has a CPA
of €94.20 against your €40 target, and "Display_Retargeting" hasn't
converted in 14 days. Want me to pause them or adjust bids first?
```

More conversation examples: [examples/](./examples)

## Documentation

- [tools-overview.md](./tools-overview.md) — What Adsroid MCP can do, by platform and category
- [guides/getting-started.md](./guides/getting-started.md) — Connecting Adsroid MCP to your AI assistant
- [guides/multi-account-and-agencies.md](./guides/multi-account-and-agencies.md) — Managing multiple clients/projects in one session
- [guides/security-and-data.md](./guides/security-and-data.md) — Authentication, data retention, and safety controls
- [faq.md](./faq.md) — Common questions
- [examples/](./examples) — Sample conversations across platforms

## Learn more

- Product page: [adsroid.com/mcp](https://adsroid.com/mcp)
- Pricing: [adsroid.com/pricing](https://adsroid.com/pricing)
- Full feature set: [adsroid.com/features](https://adsroid.com/features)

## License

This repository contains documentation only. Adsroid is a commercial SaaS product. See [Terms of Service](https://adsroid.com/terms-of-service/).