// MCP & Skill
Connect Hermes AI API to your AI agent
Copy one prompt into Claude Code, Codex, Cursor or another agent. It installs the MCP server and the Agent Skill, then you sign in once in your browser.
// 01
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
// 02
Sign in once
Your browser opens the first time your agent uses Hermes AI API. Sign in with Google or GitHub and allow the request.
What the app can do
Run models and spend your prepaid credits, and read your tasks, results and balance.
What it cannot do
Manage API keys, billing or payments, or use any admin feature.
Disconnect any time
Account security lists every connected app. Disconnecting stops its access immediately.
// 03
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?”
// Reference
Manual setup
Prefer to set things up yourself? Everything the prompt does is below.
Server URL: https://api.hermes-ai.net/mcp
claude mcp add --transport http hermes-ai-api https://api.hermes-ai.net/mcpThe skill teaches an agent the Hermes AI API workflow over the REST API with an API key. Unzip it into ~/.claude/skills (all projects) or a project's .claude/skills folder, and set HERMES_API_KEY.
mkdir -p ~/.claude/skills
curl -L https://api.hermes-ai.net/skills/hermes-ai-api.zip -o /tmp/hermes-ai-api.zip
unzip -o /tmp/hermes-ai-api.zip -d ~/.claude/skills| Tool | What it does |
|---|---|
search_models | Find models by output type or keywords, with prices. |
get_model | Read a model's input fields, allowed values and current price. |
create_task | Run a model. Charges credits only if the task succeeds. |
wait_for_task | Wait until a task finishes and return its results. |
get_task | Check a task. Finished images are returned inline. |
list_tasks | List your recent tasks. |
get_balance | Show available, reserved and spent credits. |
Machine-readable summaries for agents and AI search: what Hermes AI API is, every model, and where the docs live.