Skip to content
Get MCP AdsGet MCP Ads, home
Start free

How to connect your ad accounts to Hermes

Add your advertising accounts to Hermes Agent as a remote MCP server, with hermes mcp add and OAuth login. Tools appear in the registry on reload.

For you

What the answer looks like, and what to type to get it.

Hermes speaks the Model Context Protocol, so there is nothing to install. You paste one URL, sign in once, and your advertising accounts become tools it can call.

SetupLink to this section

bashAdd it, then sign in
hermes mcp add get-mcp-ads --url https://mcp.getmcpads.com/mcp --auth oauth
hermes mcp login get-mcp-ads

Or write it in ~/.hermes/config.yaml:

yaml~/.hermes/config.yaml
mcp_servers:
  get-mcp-ads:
    url: https://mcp.getmcpads.com/mcp

Hermes prints an authorise URL on first connect and waits for the callback on a local port. Start Hermes, or run /reload-mcp in a live session, and the tools appear in the registry next to the built-in ones.

Before it can answer anythingLink to this section

Connecting the client is one half. The other is connecting at least one advertising platform in the dashboard and ticking which accounts to expose. Both need you, not the assistant: one is a consent screen at Google or Meta, the other is a decision about which accounts a machine may read.

For your agent

The tool sequence, the parameters that matter, and what will be refused.

Both readings as Markdown: /guides/setup/hermes.md

Setting up Hermes against this gateway. The endpoint is https://mcp.getmcpads.com/mcp, and each source also has its own endpoint if a narrower tool list is wanted.

What the client does on its ownLink to this section

  1. It requests https://mcp.getmcpads.com/mcp and receives a 401 with a WWW-Authenticate header.
  2. It reads the protected resource metadata named in that header.
  3. It registers itself through dynamic client registration. No key is issued or pasted.
  4. It opens the authorisation page with PKCE and waits for the person to approve.
  5. It calls tools/list and receives the tools for the connected sources, plus four routing tools.

Checking it workedLink to this section

Call list_accounts. It answers without touching any advertising API, so it separates a connection problem from an account problem. An empty list means the platform is connected but nothing was ticked.