Skip to content

Connect Hermes Agent to Stripe

Connect Hermes Agent to Stripe in 3 steps: 1. Sign in to ApexGenius and connect Stripe. 2. Add the ApexGenius MCP server. 3. Start using Stripe in Hermes Agent.

1,000 free credits · No card required

How to connect Stripe to Hermes Agent

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

    Connect Stripe to ApexGenius

    Connect Stripe

    Stripe opens its own sign-in. Sign in and allow ApexGenius.

  2. 2ApexGenius

    Connect ApexGenius to Hermes Agent

    Copy the MCP address

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

  3. 3ApexGenius

     

    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

Which Stripe account is connected, and is it live mode or a sandbox? Use the read-only route. Do not change anything.

Start free
Written setup, step by stepShow

Before you start

  • An account with permission to use the Stripe resources you intend to connect.

1. Connect Stripe to ApexGenius

  1. Open Stripe in Connections. Choose Connect, or Add connection when offered. Give the connection a name if prompted. If Gateway setup pending appears, contact ApexGenius support before continuing.
  2. Choose the account and review access. On Stripe’s page, sign in and pick the live mode accounts or sandboxes to share, with the permissions for each. To test, pick only a sandbox. No Stripe API key is pasted into ApexGenius.
    The full Stripe sign-in page that opens when you connect Stripe, with a red box around the sign-in card.
    Connect opens Stripe's sign-in. Sign in with email, Google, a passkey or SSO, then allow ApexGenius.Open full-size image (opens in a new tab)
  3. Review the connected account and resources. Confirm the connected Stripe account on the connection page, then open Tools. Refunds, invoices, payment links and subscription changes move real money and run right away when enabled.
  4. Check the connection. Use Test connection or Check again and read the reported status. Add an AI agent from the AI agents page, choose Read only for the first test, and try the question below.
Connect Stripe →

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

Which Stripe account is connected, and is it live mode or a sandbox? Use the read-only route. Do not change anything.

Which Stripe account is connected, and is it live mode or a sandbox? Use the read-only route. Do not change anything.

Compare the returned account and resource with Stripe. Check the connection status separately from the result of the first read.

Full guide: the Stripe 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
Which Stripe account is connected, and is it live mode or a sandbox? Do not change anything.
ApexGenius
Working with ApexGenius1 tool search · 1 read
RequestCheck the account
Account scopeAuthorized connections checked
apex_search_toolsStripe account · Find Stripe readsComplete
apex_call_read_toolget_stripe_account_info · Read the connected accountComplete
Hermes Agent

Illustrative example: the connected account is Example Studio, in a sandbox. Compare it with the account you picked on Stripe’s consent page. Nothing was changed.

Read-only route
Hermes Agent

What to ask Hermes Agent about Stripe

  • Check the account

    Which Stripe account is connected, and is it live mode or a sandbox? Do not change anything.

    Runs get_stripe_account_info (read).

  • Recent payments

    List my last five payments with amount, currency and customer. Do not refund anything.

    Runs stripe_api_search (read), then stripe_api_read (read).

  • Open invoices

    Which invoices are open or past due, and for which customers? Do not finalize, void or send anything.

    Runs stripe_api_read (read).

These 3 questions use 3 of Stripe’s 10 operations. The full list is below.

  • Which Stripe account is connected, and is it live mode or a sandbox? (read)
  • List my last ten payments with amount, currency and customer. Do not change anything. (read)
  • Which invoices are open or past due, and for which customers? (read)
  • Refund this payment in full. Show me the amount, currency and customer first. (write)

What Hermes Agent can do in Stripe

10 operations: 8 read, 2 write. Read looks things up and changes nothing. Writes change Stripe and run only when you turn them on.

Account and balance

2 read
  • get_stripe_account_inforead
  • get_balance_summaryread

Find the right API method

2 read
  • stripe_api_searchread
  • stripe_api_detailsread

Read customers, payments, invoices and subscriptions

1 read
  • stripe_api_readread

Refunds, invoices, payment links and subscriptions

1 write
  • stripe_api_writewrite

Reports

1 read
  • stripe_analyticsread

Docs, planning and feedback

2 read · 1 write
  • search_stripe_documentationread
  • stripe_implementation_plannerread
  • send_stripe_feedbackwrite

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

Stripe’s consent page sets the reach: live mode accounts, sandboxes or both, with permissions for each. An administrator can turn MCP access on or off for live mode and sandboxes separately.

The connector acts only on the Stripe account you connect. It is separate from how ApexGenius bills you.

Reads use a route that checks Stripe’s live read-only label. stripe_api_write moves money and runs right away when enabled.

For some writes, such as refunds, Stripe returns its own confirmation link. Approve it on Stripe, then ask your AI to retry.

Disconnecting ends ApexGenius access and asks Stripe to revoke the grant. It does not undo a refund, invoice or subscription change that already ran.

Start free

Questions about connecting Hermes Agent to Stripe

Updated November 12, 2026.

How do I connect Hermes Agent to Stripe?

Connect Hermes Agent to Stripe through ApexGenius in three steps. Sign in to ApexGenius and connect Stripe on the Stripe page, picking the accounts or sandboxes to share. 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 open a task in Hermes Agent and ask a question about your Stripe. Start with a read, so nothing changes.

How do I check that Hermes Agent can use Stripe?

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: “Which Stripe account is connected, and is it live mode or a sandbox? Use the read-only route. Do not change anything.”

Is there a Stripe MCP server for Hermes Agent?

Yes. ApexGenius is an MCP server that Hermes Agent connects to once. It carries your Stripe connection and 10 Stripe operations, so Hermes Agent does not need a separate Stripe integration or plugin. You set it up one time and add each agent the same way.

What can Hermes Agent do in Stripe once it is connected?

Hermes Agent can run 10 Stripe operations through ApexGenius: 8 reads that confirm the account and balance, look up API methods, read customers, payments, invoices and subscriptions, and run reports, and 2 writes that create refunds, invoices and payment links or send feedback.

Can Hermes Agent read my Stripe payments?

Only on the accounts or sandboxes you grant on Stripe’s consent page, with the permissions you set for each. To test, pick only a sandbox. The connector acts only on the Stripe account you connect and never reaches how ApexGenius bills you.

Can Hermes Agent change my Stripe?

Not until you enable the write tool, and Stripe writes move real money. Test in a sandbox first. A write runs right away when enabled, and Stripe sends its own confirmation link for some, such as refunds. A refund cannot be undone.

Can I use the same Stripe connection with Claude, ChatGPT, Grok Bot or Muse?

Yes. One Stripe connection in ApexGenius works with every compatible agent you add, including Claude, ChatGPT, Grok Bot or Muse. Each agent gets its own access choice and its own short setup, so you can pick read only for one agent and more for another.

Connect Stripe to Hermes Agent today

Start free

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