MCP server · early access
Google Ads MCP server
Connect your Google Ads account to Claude Code, Cursor or any MCP client. One Cinble key, no API tokens to manage, read only.
No disponible en el plan Gratis
The Model Context Protocol (MCP) is the open standard that lets AI assistants call external tools. Cinble runs a hosted Google Ads MCP server, so instead of registering a developer app, generating API tokens and babysitting a server of your own, you create a key in Cinble, point your assistant at one URL and start asking questions about your campaigns.
The endpoint
Server URL
https://google-ads.mcp.cinble.com
Transport is HTTP, and authorization is an access key you create in Cinble, under Connections, MCP. On the key you choose the server, the accounts it can see and when it expires, and you can revoke it at any time: it stops answering immediately. Answers come from what Cinble has already synced from your connected accounts, up to the last complete day.
How to connect
Claude Code
claude mcp add --transport http google-ads https://google-ads.mcp.cinble.com --header "Authorization: Bearer YOUR_KEY"Cursor, VS Code and other JSON-configured clients
{
"mcpServers": {
"google-ads": {
"url": "https://google-ads.mcp.cinble.com",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}Add the block to your client's MCP configuration file, replace YOUR_KEY with the key you created in Cinble and restart it.
Custom agents
Any client that speaks MCP over HTTP and lets you set an authorization header works, including agents you build with an MCP-compatible SDK.
Claude on the web and ChatGPT
Coming soon. Their custom connectors require an OAuth sign-in, which we are building. Until then, use one of the clients above.
What you can ask once it is connected
You ask in plain language. The assistant picks the tools it needs, reads the numbers Cinble has synced from your account and answers with the figures it used:
Where am I wasting spend on search terms this month?
✓ get_search_terms google-ads
Three terms took $2,140 with no conversions in the last 30 days:
✓ get_keyword_performance google-ads
Reply to Claude…
Other questions people bring to it:
"Which campaigns increased cost per conversion more than 20% versus last month?"
"Is Performance Max cannibalizing my brand search campaign?"
"Which broad match keywords spend the most without converting?"
Nothing is copied and pasted, and the numbers are the same ones on your Cinble dashboard. During early access the assistant recommends the move and leaves the execution to you.
Tools it exposes
| Tool | What it returns |
|---|---|
| list_ad_accounts | The accounts the key can see, with name, ID, currency, time zone and last sync. |
| list_campaigns | Campaigns, with objective, status and budget. |
| list_creatives | The ads themselves: headlines, body copy, destination, format and approval state. |
| get_performance | Spend, impressions, clicks, CTR, CPC, CPM, conversions, cost per conversion and ROAS, as a total and per campaign. |
| get_timeseries | One row per day, to find when something changed. |
| compare_periods | Two date ranges side by side, with deltas already computed. |
| get_search_terms | Search terms with spend and conversions, the ones that spent without converting, and the words they share. |
| get_keyword_performance | Per-keyword results, with the match type. |
| get_audience_breakdown | The numbers by age, gender, region, device or placement. |
| get_conversion_actions | Conversions split by the event that produced them. |
| get_creative_performance | Per-ad results, so the assistant can tell which ad is carrying a campaign. |
| get_campaign_health | A 0 to 100 score per campaign against its own past, naming what is dragging it. |
Tool names and arguments are discoverable from the server itself, so the assistant learns the surface on connection. The list above is what early access ships with.
Permissions and security
- Read-only during early access. No tool in the current set can spend money, pause a campaign or edit a budget. An assistant that misunderstands you cannot cost you anything.
- You choose the accounts. When you create the key you tick the accounts it can see, or leave it on all of them. Accounts outside the key are invisible to the server.
- Revocable at any time from Cinble. The key stops answering immediately.
- Write tools are planned, not default. When they arrive they will be an explicit per-account opt-in with a confirmation step, matching how the Cinble copilot works.
Hosted versus running your own
Open-source servers exist, and they are a reasonable choice if you want full control of the process. What you take on is the plumbing:
| Self-hosted | Cinble hosted | |
|---|---|---|
| Developer token | Apply through a manager account and wait for Google's approval | Already approved, ours |
| OAuth setup | Cloud project, OAuth client, refresh token | Sign in with Google |
| Manager accounts | You handle login customer IDs by hand | Resolved for you |
| Hosting and rate limits | Yours to keep alive and within quota | Managed |
| Time to first answer | Days, waiting on token approval | Create a key and paste one command |
Where the copilot picks up
An MCP connection answers whatever you think to ask, and runs only while you are in the chat. What it cannot do is watch the account while you are not looking. That is the other half of Cinble: the copilot consolidates the same connected accounts into one panel, reads their history and puts budget moves in front of you ranked by impact.
Frequently asked questions
What is the Google Ads MCP server?
A hosted Model Context Protocol server run by Cinble that connects your Google Ads account to AI assistants, so they can read campaigns, keywords, search terms and metrics and answer questions in plain language.
Do I need a Google Ads developer token?
No. Applying for one and waiting for Google's approval is the slowest part of building your own server. Cinble already holds the approved token, so you connect Google Ads to Cinble and create a key.
Can the assistant change my campaigns?
Not during early access. The server ships read-only, so no tool can pause a campaign, change a budget or add a keyword. Write tools are planned later as an explicit per-account opt-in.
Are the numbers real time?
No. The server reads what Cinble has already synced, up to the last complete day, and every answer says how far the data goes. Today is left out because the platform is still counting it.
How much does it cost?
It comes with any paid Cinble plan, at no extra cost.
Get the server enabled on your account
Early access is opening in batches to accounts on a paid plan. Join the waitlist and we will turn on the Google Ads MCP server alongside the copilot.
Join the waitlist