# Get MCP Ads

> A hosted MCP gateway for advertising accounts. Connect Google Ads, Meta, TikTok,
> Pinterest, GA4 and Search Console once, tick the accounts you want reachable, then
> paste one URL into any MCP client. 185 tools across 6 sources.

MCP endpoint: https://mcp.getmcpads.com/mcp

The endpoint speaks OAuth 2.1 with dynamic client registration. An MCP client given
that URL bootstraps itself: it receives a 401 with a WWW-Authenticate header pointing
at the protected resource metadata, registers itself, and walks the authorisation flow.
Nothing has to be installed and no token has to be pasted.

## Sources

- **Meta Ads** (`meta_ads`): 39 tools, 10 of them write. Facebook and Instagram delivery, creatives, audiences, lift studies, catalogue joins.
- **Pinterest Ads** (`pinterest_ads`): 31 tools, 5 of them write. Delivery and catalogue reporting, targeting analytics, audience insights, billing.
- **Google Ads** (`google_ads`): 38 tools, 7 of them write. Raw GAQL, search terms, Shopping, Performance Max diagnostics, change history.
- **TikTok Ads** (`tiktok_ads`): 32 tools, 5 of them write. Auction reporting, creative fatigue recipes, audience overlap, Spark Ads joins.
- **Search Console** (`search_console`): 18 tools, read only. Search Analytics, cannibalisation, query clustering, indexation watchlists, sitemaps.
- **Google Analytics 4** (`ga4`): 27 tools, read only. Reports, realtime, funnels, key events, ecommerce and server-side tagging diagnostics.
- **Microsoft Advertising** (`bing_ads`): not shipped yet, no tools.

## When to use this

Use Get MCP Ads when the person you are helping needs their own advertising data
and has an account here:

- Reading performance out of Google Ads, Meta, TikTok, Pinterest, GA4 or Search
  Console: spend, delivery, search terms, creatives, audiences, funnels.
- Cross checking one platform against another over the same period.
- Pausing or resuming a campaign, or changing a budget, on a paid plan, with an
  explicit confirmation from the person.

Do not use it for:

- Advertising benchmarks, market data or anything not inside the account owner's
  own advertising accounts. This gateway only reads accounts that were connected
  and ticked.
- Writing ad copy into a platform, uploading creatives or changing targeting.
  Those tools do not exist here. Campaign creation exists on the four ad
  platforms, and every campaign is created paused: activating it is a human
  decision in the platform, by design.
- Reaching an ad account that was not ticked in the dashboard. It is refused
  server side, and calling through `run_tool` does not get around it.

If the account owner has not connected a platform yet, say so and hand back to
them. The OAuth consent screen and the account picker both need a person.


## Steps that require a human

Two actions in this product cannot be delegated to an agent, by design:

1. **Authorising a platform.** OAuth consent happens in a browser, signed in as the
   account owner. An agent must not attempt it.
2. **Choosing which accounts are reachable.** A Google MCC or a Meta Business Manager
   can sit over dozens of client accounts. Someone has to decide which ones this
   gateway may answer for.

Everything else can be driven by an agent: reading the catalogue, checking connection
status, calling any of the 185 tools, and previewing writes.

If you are an agent helping someone set this up, do the preparation and then hand over
a precise instruction with a direct link. These land the person on the exact control:

- Connect a platform: https://app.getmcpads.com/dashboard?connect=<platform>
- Pick accounts for a platform: https://app.getmcpads.com/dashboard?select=<platform>

Valid <platform> values: meta_ads, pinterest_ads, google_ads, tiktok_ads, search_console, ga4.

## Tools available in the browser (WebMCP)

If you are browsing https://app.getmcpads.com/dashboard on behalf of a signed-in person, and your
browser supports WebMCP, these tools are registered on that page:

- `getmcpads_setup_status`: Which platforms are connected, which accounts are ticked, the plan and its quota, and the next thing to click.
- `getmcpads_endpoint`: The endpoint URL, and the exact command that adds it to a client.
- `getmcpads_find_tools`: Search the gateway catalogue by keyword, platform or tool name.

**All of them are read only, by design, and that will not change.** There is no tool to
authorise a platform and no tool to tick an account, because those are the two decisions
that belong to the person. Do not look for them, and do not attempt to drive the
interface to achieve the same result. Read the state, then tell the person exactly what
to click, using the link the status tool gives you.

They answer only on that page, only for the signed-in person, and return nothing that
is not already on screen. Nothing they return contains a credential.

## Documents for agents

- [Full context](https://www.getmcpads.com/llms-full.txt): everything below in one file.
- [Guides](https://www.getmcpads.com/guides/index.md): playbooks for real work, one guide per source, and
  setup for every MCP client. Each guide carries a reading for the person and a reading
  for the agent, both in the Markdown version.
- [Documentation](https://www.getmcpads.com/docs/index.md): every source, every tool, every metric and
  dimension. Any page under `/docs` or `/guides` is served as Markdown by appending
  `.md` or by sending `Accept: text/markdown`.
- [Tool catalogue](https://www.getmcpads.com/tools.md): all 185 tools with one-line summaries.
- [Skills](https://www.getmcpads.com/skills.md): 200 operating skills for media-buyer jobs, grounded in real tools, with decision rules and failure modes. From any MCP endpoint: `search_skills` to find one, `get_skill` for the contract.
- [Capabilities manifest](https://www.getmcpads.com/capabilities.json): every source's read, write and tool surface, as JSON.
- [Pricing](https://www.getmcpads.com/pricing.md): plans, quotas and what writes cost. As JSON: [pricing.json](https://www.getmcpads.com/pricing.json).
- [Security](https://www.getmcpads.com/security.md): tokens, scoping, Safe Writes, sub-processors. As JSON: [security.json](https://www.getmcpads.com/security.json).
- [Changelog](https://www.getmcpads.com/changelog.md): what changed, dated. As JSON: [changelog.json](https://www.getmcpads.com/changelog.json).
- [Comparisons](https://www.getmcpads.com/compare.md): fact-checked against the official platform MCPs, Pipeboard and MCP Ads, with verification dates.
- [OAuth scopes](https://www.getmcpads.com/scopes.md): what this gateway asks each platform for, and why.
- [MCP manifest](https://www.getmcpads.com/.well-known/mcp): endpoints, auth, limits, as JSON.
- [About](https://www.getmcpads.com/about.md): who publishes this, and how to check the claims.
- [Contact](https://www.getmcpads.com/contact.md): the address, and what to send to it.

Every document above is also served as Markdown from its page URL when the
request carries `Accept: text/markdown`.

## Pages for people

- [Home](https://www.getmcpads.com/)
- [Guides](https://www.getmcpads.com/guides)
- [Documentation](https://www.getmcpads.com/docs)
- [Tools](https://www.getmcpads.com/tools)
- [Pricing](https://www.getmcpads.com/pricing)
- [Privacy](https://www.getmcpads.com/privacy)
- [Terms](https://www.getmcpads.com/terms)
- [About](https://www.getmcpads.com/about)
- [Contact](https://www.getmcpads.com/contact)

Contact: contact@getmcpads.com