Skip to content

Connect Hermes Agent to ChatGPT Ads

Connect Hermes Agent to ChatGPT Ads: 1. Connect ChatGPT Ads in ApexGenius. 2. Add the ApexGenius MCP server. 3. Start using ChatGPT Ads in Hermes Agent.

1,000 free credits · No card required

How to connect ChatGPT Ads to Hermes Agent

  1. 1Sign in to ApexGenius and connect ChatGPT Ads
  2. 2Add the ApexGenius MCP server to Hermes Agent
  3. 3Start using ChatGPT Ads in Hermes Agent
  1. 1ChatGPT Ads

    Connect ChatGPT Ads to ApexGenius

    Connect ChatGPT Ads

    Create an API key in ChatGPT Ads. You paste it into ApexGenius once.

  2. 2ApexGenius

     

    Paste it into ApexGenius

    Paste your ChatGPT Ads key into ApexGenius once.

  3. 3ApexGenius

    Connect ApexGenius to Hermes Agent

    Copy the MCP address

    On Start, pick API key, open Manual setup, and copy the MCP address.

  4. 4ApexGenius

     

    Approve access

    ApexGenius opens its approval page. Review the access, then approve.

Add the ApexGenius MCP server to Hermes Agent

Hermes Agent reads MCP servers from ~/.hermes/config.yaml, under mcp_servers.

  1. Add the apexgenius entry under mcp_servers and save the file.
  2. In a new terminal, run hermes mcp login apexgenius. Hermes prints an authorize URL and opens your browser when it can.
  3. Sign in to ApexGenius and approve access.
  4. Start Hermes with hermes chat, or run /reload-mcp in a session that is already open.
Add to ~/.hermes/config.yaml
mcp_servers:
  apexgenius:
    url: "https://server.autom8.pro/mcp"
    auth: oauth

Check it. Run hermes mcp test apexgenius. It connects, lists the tools it found and exits 0 when the connection completes.

Steps follow Hermes Agent documentation, MCP (Model Context Protocol) (opens in a new tab), read November 12, 2026.

Then ask Hermes Agent

List my ChatGPT Ads campaigns with status and daily budget, and name the connected ad account and currency. Do not pause or activate anything.

Start free
Written setup, step by stepShow

Before you start

  • A ChatGPT Ads Manager account with access to the ad account you want to connect.
  • An Ads API key created in Ads Manager under Settings. Each key covers one ad account, and it is not the Conversions API key used by a website pixel.

1. Connect ChatGPT Ads to ApexGenius

  1. Create an Ads API key in Ads Manager. In ChatGPT Ads Manager open Settings, then General. Under API Keys choose Create New Key, name it, and copy the key once. It is the Ads Management key, not a conversion key.
    The full ChatGPT Ads Manager Settings page with account details and existing keys blurred, and a red box and arrow marking the Create New Key button.
    Settings, then General. Create New Key, marked in red, mints an Ads Management key for this ad account. Account details are blurred in this capture.Open full-size image (opens in a new tab)
    The Create New API Key dialog in ChatGPT Ads Manager with a Key Name field and a note that Ads Manager keys are separate from conversion keys.
    Name the key and choose Create. Copy it once; Ads Manager shows it masked afterwards. Conversion keys are managed separately.Open full-size image (opens in a new tab)
  2. Open ChatGPT Ads in Connections. Sign in to ApexGenius, open Connections, choose ChatGPT Ads, and select Connect.
  3. Enter the Ads API key. Paste the key from Ads Manager Settings. ApexGenius supplies the api.ads.openai.com address, checks the key against the ad account, and stores it encrypted.
    The Connect ChatGPT Ads dialog over the connection page in ApexGenius, with the ChatGPT Ads API key field and the Connect button.
    Paste the Ads API key into the ChatGPT Ads API key field, then choose Connect. The Conversions API key used by your website pixel is a different key.Open full-size image (opens in a new tab)
  4. Review the tools. Open Tools. Reads cover the account, campaigns, ad groups, ads and daily insights. Enabled pause and activate tools run when called. Activating starts spend.
  5. Verify the connected ad account. Use Test connection, then ask your AI the question below. Compare the account name and currency with Ads Manager and check Tool Activity.
Connect ChatGPT Ads →

2. Connect ApexGenius to Hermes Agent

Use this server address when adding the connection:

https://server.autom8.pro/mcp

The steps are above, under Add the ApexGenius MCP server to Hermes Agent. These notes apply to Hermes Agent only.

  • On a server with no browser. Hermes prints “Or paste the redirect URL here” beside the authorize URL. Open the URL on your own machine, approve, and paste the full URL the browser lands on. That page shows a connection error, which is expected.
  • Use a new terminal for the sign-in. Editing config.yaml inside a running session reloads MCP with a 30 second limit, too short for a browser sign-in. hermes mcp login waits five minutes.
  • Where the sign-in is kept. Hermes caches the tokens at ~/.hermes/mcp-tokens/apexgenius.json and reuses them until a refresh fails. Run hermes mcp login apexgenius again if that happens.
  • Tool names. Hermes prefixes each MCP tool with the server name, so the ApexGenius tools carry apexgenius in their names.
  • Access. When ApexGenius asks what Hermes Agent may use, choose Read only for the first test, or Custom to limit it to the tools you need.

3. Verify one safe read

List my ChatGPT Ads campaigns with status and daily budget, and name the connected ad account and currency. Do not pause or activate anything.

List my ChatGPT Ads campaigns with status and daily budget, and name the connected ad account and currency. Do not pause or activate anything.

Confirm the account and campaign list match Ads Manager. Listing campaigns changes nothing and spends nothing; it does not test pause or activate.

Full guide: the ChatGPT Ads setup guide.

What it looks like in Hermes Agent

Illustration of a task, not a recorded customer result. Your answers come from the account and dates you choose.

How the route works
Hermes Agent
Hermes AgentApexGenius MCP route
Name the connected ChatGPT ad account, its currency and time zone.
ApexGenius
Working with ApexGenius3 reads
RequestConnected read
Account scopeAuthorized connections checked
Salesforceapex_call_read_toolsalesforce_read · Find matching recordsComplete
Salesforceapex_call_read_toolsalesforce_read · Read related activityComplete
n8napex_call_read_tooln8n_get_workflow · Check workflow statusComplete
Hermes Agent

Three safe example reads returned results. Nothing was changed.

Read-only route
Hermes Agent

Try asking

Name the connected ChatGPT ad account, its currency and time zone.

List my ChatGPT Ads campaigns with status and daily budget. Do not change anything.

Show spend, clicks and conversions per campaign for the last seven complete days.

Pause the campaign I name. Show me the campaign and its daily budget first.

What Hermes Agent can do in ChatGPT Ads

15 operations: 13 read, 2 write. Read looks things up and changes nothing. Writes change ChatGPT Ads and run only when you turn them on.

Account

2 read
  • get_ad_accountread
  • list_ad_accountsread

Campaigns

3 read
  • list_campaignsread
  • get_campaignread
  • get_campaign_insightsread

Ad groups and ads

6 read
  • list_ad_groupsread
  • get_ad_groupread
  • get_ad_group_insightsread
  • list_adsread
  • get_adread
  • get_ad_insightsread

Account insights and conversions

2 read
  • get_account_insightsread
  • list_conversion_event_settingsread

Campaign state

2 write
  • pause_campaignwrite
  • activate_campaignwrite

You choose the access. When you approve Hermes Agent, pick Full access, Read only, or Custom.

An Ads API key is scoped to one ad account. Connect again for a second account.

Reads never change anything. Pause and activate are the only writes, both run when enabled, and activating starts spend at the campaign budget.

Archive, budget changes, spend limits, key creation and image uploads are not exposed. Image changes happen in Ads Manager.

Disconnecting stops future gateway access. It does not undo a pause or activate that already ran.

Start free

Questions about connecting Hermes Agent to ChatGPT Ads

Updated November 12, 2026.

How do I connect Hermes Agent to ChatGPT Ads?

Sign in to ApexGenius and connect ChatGPT Ads. In Hermes Agent, add an apexgenius entry with the ApexGenius MCP address and auth: oauth under mcp_servers in ~/.hermes/config.yaml, then run hermes mcp login apexgenius. Then ask Hermes Agent: “List my ChatGPT Ads campaigns with status and daily budget, and name the connected ad account and currency. Do not pause or activate anything.” Start with a read, so nothing changes.

How do I check that Hermes Agent can use ChatGPT Ads?

Run hermes mcp test apexgenius. It connects, lists the tools it found and exits 0 when the connection completes. In a session that is already open, /reload-mcp picks up a config change. If the sign-in has expired, run hermes mcp login apexgenius again. Then ask: “List my ChatGPT Ads campaigns with status and daily budget, and name the connected ad account and currency. Do not pause or activate anything.”

Can my AI read spend and conversions?

Yes. Daily insights return spend, impressions, clicks and conversions by campaign, ad group or ad. Conversions count only the events attached to a campaign in Ads Manager.

Can my AI turn a campaign on or off?

It can pause or activate when the tool is enabled. Activating starts spend until someone pauses the campaign again.

Can it create ads or change budgets?

No. Creating campaigns or ads, editing budgets, spend limits, archiving and image uploads are not exposed through ApexGenius. Use Ads Manager for those.

Is this the same key as my website pixel?

No. The Conversions API key belongs to your site. The Ads API key is created separately in Ads Manager Settings and covers one ad account.

Connect ChatGPT Ads to Hermes Agent today

Start free

1,000 free credits. No card required. Disconnect any time.