Connect Hermes Agent to Any API

Empower Hermes autonomous agents to interact with third-party APIs without sharing root credentials or managing OAuth browser redirects.

Preferred: 1-Shot Setup Prompt

Paste this prompt directly into Hermes Agent. It safely installs the agent skill and wires the Remote MCP endpoint:

I want to install the AgentOnboard skill and MCP server:

1. For skill, run:
npx skills add agentonboard/skills -g -a '*' -s '*' -y

2. For MCP, run the setup command (or in ~/.hermes/config.yaml):
hermes mcp add agentonboard --url https://agentonboard.xyz/api/mcp

3. API key setup:
Ask me for my AgentOnboard API key (starts with aon_live_). If I provide it, configure the server with my key. If I prefer not to provide it in chat, guide me how to set the key securely.

4. Once done, remind me: Restart Hermes process to load the get_token tool.
Rules: Never commit or echo the full API key into persistent files or chat logs.

Your secret key (aon_live_...) is configured directly on the client transport. It is never stored in Hermes Agent’s persistent conversation history or prompt cache.

Alternative: Manual Setup

If you prefer to configure Hermes Agent by hand without using the automated prompt:

1. Install the agent skill

Installs workflow instructions so Hermes Agent understands auth.md discovery:

npx skills add agentonboard/skills -g -a '*' -s '*' -y

2. Add the Remote MCP server

Run in your terminal (replace <YOUR_API_KEY> with your live key):

hermes mcp add agentonboard --url https://agentonboard.xyz/api/mcp

2. Configure ~/.hermes/config.yaml

Add this configuration to ~/.hermes/config.yaml:

~/.hermes/config.yaml

mcp_servers:
  agentonboard:
    type: http
    url: https://agentonboard.xyz/api/mcp
    headers:
      Authorization: Bearer <YOUR_API_KEY>

3. Reload session

Restart Hermes process to initialize the new tools.

Verify connection

In your Hermes Agent chat or terminal, ask:

Run the whoami tool and tell me which AgentOnboard account is connected.

Hermes Agent will call the Remote MCP server and print your verified email:

{
  "email": "user@example.com",
  "key_prefix": "aon_live_abcd"
}

Frequently asked about Hermes Agent

Can Hermes run unattended background jobs?

Yes. Because Remote MCP uses bearer authentication over HTTPS, background and cron processes can request scoped tokens on demand without interactive browser prompts.

Ready to run Hermes Agent with AgentOnboard?

Create an API key in your dashboard and paste the setup prompt. Takes less than two minutes.

Get your API key All agents