Skip to content

Connect Hermes AI API to your AI agent

Use Hermes AI API from Claude Code, Codex, Cursor or any other agent. Pick one of three ways in, or copy one prompt and let your agent set itself up.

Three ways in

They work together: the MCP server runs tasks, while the docs and the skill teach an agent the API.

AI docs

No install

Give your agent a URL. It reads what Hermes AI API is, every model and the full task workflow, then calls the REST API with your API key.

Needs: An API key to run tasks

https://api.hermes-ai.net/llms.txt

MCP server

Recommended

Connect any MCP client to one remote URL over HTTP. Sign in once in your browser; your agent can then search models, run tasks and fetch results.

Needs: Your Hermes AI account, no API key

https://api.hermes-ai.net/mcp

Agent Skill

Local

Download a SKILL.md folder into your agent's skills directory. It teaches the agent the task workflow over the REST API.

Needs: An API key in HERMES_API_KEY

https://api.hermes-ai.net/skills

Copy this prompt into your agent

Works with agents that can run commands, such as Claude Code, Codex and Cursor. Your agent does the setup.

Setup prompt

Set up Hermes AI API (https://api.hermes-ai.net) so you can generate images, videos and music for me.

1. Add the Hermes AI API MCP server, named hermes-ai-api, at https://api.hermes-ai.net/mcp (Streamable HTTP with OAuth sign-in).
   - Claude Code: claude mcp add --transport http hermes-ai-api https://api.hermes-ai.net/mcp
   - Codex: codex mcp add hermes-ai-api --url https://api.hermes-ai.net/mcp
   - Other clients: add it to your MCP configuration.
2. Install the Hermes AI API Agent Skill: download https://api.hermes-ai.net/skills/hermes-ai-api.zip and unzip it into your skills folder (Claude Code: ~/.claude/skills).
3. Tell me how to sign in to Hermes AI API in my browser (Claude Code: run /mcp and choose hermes-ai-api; Codex: codex mcp login hermes-ai-api), then confirm the tools are available.

Reference: https://api.hermes-ai.net/llms.txt

The prompt adds the MCP server, installs the Agent Skill and explains how to sign in. How sign-in works

Ask for what you want

Ask your agent in plain language. It picks a model, shows the price and runs the task.

  • “Use Hermes AI API to generate a 16:9 image of a lighthouse at sunrise.”
  • “Turn this image into a 10-second video with Hermes AI API.”
  • “Write a short upbeat song about Monday mornings with Hermes AI API.”
  • “How many Hermes AI API credits do I have left?”

Set up a specific client

Step-by-step guides for each client, with the exact command or config file.