MCP server

Goldbeater’s findings, in the assistant you already use.

Connect Claude, ChatGPT or Cursor to Goldbeater’s MCP server, and your assistant reads what the checks found on your Google Ads accounts: each finding with its evidence, what it’s worth and the fix Goldbeater drafted.

The server's address
https://api.goldbeater.ai/mcp
Read-only
The tools read what the checks found. A change reaches your account only when a person approves it in Goldbeater and presses Apply.
115 checks
They run on every connected account every 24 hours and whenever you ask, and your assistant reads their latest pass.
One sign-in
You sign in with your Goldbeater account. There's no Google Cloud project, OAuth client or access level to set up.
No queries
A call reads the findings Goldbeater already stored, and sends nothing to Google Ads.
01

What your assistant gets

Google’s own Google Ads MCP server lets an assistant query your account: it writes each query itself, so it has to know what to look for. Goldbeater’s hands it the finished analysis instead. Goldbeater runs 115 checks for 187 problems on every connected account, every 24 hours and whenever you ask, and your assistant reads what they found: each finding with its evidence, its figures and tables, what it’s worth and the fix Goldbeater drafted. It’s the same reading Goldbeater’s own analyst works from in the console.

So you can ask questions like these, and the answer comes from the checks rather than from a query written a minute ago:

  • What did Goldbeater find on my account, most costly first?
  • What’s the evidence that this conversion stopped recording?
  • Which checks ran last time, and did any part of the account go unread?

To connect Google’s server as well, for a question the checks don’t cover, the Google Ads MCP guide sets it up step by step.

02

The three tools

Your assistant picks the tool your question needs, and starts with the first to find your accounts.

  • list_accountsEvery Google Ads account you can open in Goldbeater, with its workspace, its currency, when its checks last ran and how many findings are open.
  • list_findingsWhat the checks found on one account’s latest pass, most severe and costly first: each finding with its evidence, its figures and tables, what it’s worth and the fix Goldbeater drafted. It narrows to one check or one campaign when asked.
  • what_ranEvery check that ran on an account’s latest pass, what each looks for and how it judges, and whether it found anything.

Money is in each account’s own currency, and only wasted spend is money lost. The server tells your assistant never to add different kinds of money together, and to say an estimate is an estimate.

03

What a connection can see, and what it can't

  • The accounts you can open in Goldbeater, and no others. Every call checks what you can open at that moment, through the same workspace rules as the app, so an account you lose access to, or a workspace you leave, is out of its reach at once.
  • It reads, and never changes anything. The tools read what the checks stored from their latest pass, and send nothing to Google Ads. A change still reaches your account only in Goldbeater, where a person approves each one and presses Apply.
  • A workspace on its free first look sees what the app shows it: how many findings the checks raised and what they’re worth. The findings themselves open with the free trial.
  • Your Goldbeater sign-in, and nothing from Google Cloud. You sign in with Goldbeater’s own Google sign-in, and a consent screen names the app that’s asking and where its access goes before you allow it. There’s no Cloud project, access level or API key.
  • You can withdraw it at any time. Disconnect the app from your Profile in Goldbeater, under Connected apps, or remove it in the assistant.

What the tools return goes into your conversation with the assistant, under the terms you have with its maker, as anything you paste into it does. What the security page says about connected assistants.

04

Connect Claude

Claude on the web and in the desktop app

Claude connects to Goldbeater as a custom connector, in the desktop app and on the web alike, on every plan. The Free plan allows one custom connector. On Pro and Max:

  1. Go to Customize › Connectors.
  2. Select the + button, then Add custom connector.
  3. Name it Goldbeater, paste the server’s address, and select Continue.
The server's address
https://api.goldbeater.ai/mcp
  1. Keep what Claude detects, Sign in now and Use Claude’s published identity, and select Add.
  2. Select Connect, sign in to Goldbeater if it asks, check the accounts the consent screen lists, and select Allow.
  3. Ask about an account. Claude asks before it uses each tool; all three only read, so Always allow saves the question. If a conversation doesn’t use Goldbeater, turn it on from the + button, under Connectors.

On Team and Enterprise, an Owner adds it first: Organization settings › Connectors, then Add, Custom and Web, and the address. Each member then finds Goldbeater under Customize › Connectors and selects Connect.

Claude Code

Add the server
claude mcp add --transport http goldbeater https://api.goldbeater.ai/mcp

Add --scope user to have it in every project. Then run /mcp inside Claude Code, choose goldbeater and sign in in your browser, or run claude mcp login goldbeater from your shell.

05

Connect ChatGPT

ChatGPT connects to an MCP server in developer mode, on Plus, Pro, Business, Enterprise and Education accounts, on ChatGPT’s website. On a Business, Enterprise or Education workspace, whether you can turn it on can depend on the workspace’s policy.

  1. Go to Settings › Security and login and turn on Developer mode.
  2. Open ChatGPT’s Plugins page and select the + button.
  3. Name it Goldbeater, give it a description, and under Connection paste the server’s address, with its /mcp path.
  4. Create the connection, then sign in to Goldbeater when ChatGPT asks and select Allow.
  5. In a conversation, choose Developer mode from the + menu and select Goldbeater.

ChatGPT asks you to confirm a tool that writes. Goldbeater’s three are marked read-only, so ChatGPT treats them as reads.

06

Connect Cursor

Cursor reads its servers from mcp.json: ~/.cursor/mcp.json for every project, or .cursor/mcp.json in one.

  1. Add this entry to the file, beside any servers already in it.
The entry for mcp.json
{
  "mcpServers": {
    "goldbeater": {
      "url": "https://api.goldbeater.ai/mcp"
    }
  }
}
  1. Sign in to Goldbeater when Cursor asks, and select Allow. Cursor registers itself, so there’s no client ID to enter.
  2. Turn it on or off from Customize in Cursor’s sidebar. Cursor asks before it uses an MCP tool, unless you tell it otherwise.
07

Questions

How is this different from Google’s Google Ads MCP server?
Google’s lets an assistant query your account, and it has to know what to ask. Goldbeater’s gives it what the checks found, with the evidence, the figures and the fix. The two work side by side.
Does a call count against my Google Ads API limits?
No. A call reads the findings Goldbeater stored from the latest pass, and sends nothing to Google Ads.
Can my assistant change my Google Ads account?
No. The tools only read. Changes are made in Goldbeater, where a person approves each one and presses Apply, and an applied change can be undone.
How fresh are the findings?
As fresh as the latest pass. The checks run every 24 hours and whenever someone presses Run checks in Goldbeater, and each account says when its checks last ran.
08

Sources

Each step above was read from its maker’s own documentation. Each page is named below with what this page took from it; we name these pages rather than link them.

  1. [1]Claude Help Center: Get started with custom connectors using remote MCP

    • Custom connectors work in Claude on the web, in the desktop app and in Cowork, on the Free, Pro, Max, Team and Enterprise plans, and Free allows one.
    • On Pro and Max, a connector is added under Customize › Connectors: the + button, Add custom connector, the server’s address, then Add.
    • On Team and Enterprise, an Owner adds it first, under Organization settings › Connectors (Add, then Custom, then Web), and each member then connects to it under Customize › Connectors.
    • Claude reaches a connector’s server from Anthropic’s cloud, whichever Claude app you use, and a conversation turns connectors on from its + button, under Connectors.
  2. [2]Goldbeater's own connection from Claude on the web

    • After the name and address, Claude detects that the server signs you in and reads Claude’s published identity, and a new connector’s tools ask for approval each time until you choose Always allow.
  3. [3]Claude Code documentation: Connect Claude Code to tools via MCP

    • Claude Code’s mcp add command adds a remote server over the http transport, and the user scope makes it available in every project.
    • Inside Claude Code, /mcp runs a server’s sign-in in your browser, and claude mcp login does the same from your shell.
  4. [4]OpenAI developer documentation: ChatGPT developer mode

    • Developer mode is available to Plus, Pro, Business, Enterprise and Education accounts on ChatGPT’s website, and is turned on under Settings › Security and login.
    • An app for a remote server is made from the + button on ChatGPT’s Plugins page, and a conversation uses it from Developer mode in its + menu.
    • ChatGPT signs in with OAuth, by a client ID metadata document or dynamic client registration where the server supports them.
    • ChatGPT treats a tool marked read-only as a read, and asks you to confirm a tool that writes.
  5. [5]OpenAI developer documentation: Connect and test your plugin (ChatGPT)

    • An app takes a name, a description and, under Connection, the server’s address with its /mcp path, and whether developer mode is available can depend on a workspace’s policy.
  6. [6]Cursor documentation: Model Context Protocol (MCP)

    • A remote server is an entry with a url in mcp.json: ~/.cursor/mcp.json for every project, or .cursor/mcp.json in one.
    • Cursor signs in to a remote server with OAuth, registering itself unless it’s given a client’s credentials, and asks before it uses an MCP tool unless told otherwise.
    • Servers are turned on and off from Customize, in Cursor’s sidebar.

7-day trial · nothing charged until day 7

Try it for a week. See the money it saves. It pays for itself.