Skip to content

Codex

Add the Hermes AI API MCP server to the Codex CLI and sign in from the terminal.

Add the MCP server

Run this in a terminal.

terminal
codex mcp add hermes-ai-api --url https://api.hermes-ai.net/mcp

Sign in

Sign in from the terminal. Your browser opens to sign in. Sign in with Google or GitHub and allow the request.

terminal
codex mcp login hermes-ai-api
  • 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.

MCP tools

Once signed in, ask in plain language. Your agent picks a model, shows the price and runs the task with these tools:

ToolWhat it does
search_modelsFind models by output type or keywords, with prices.
get_modelRead a model's input fields, allowed values and current price.
create_taskRun a model. Charges credits only if the task succeeds.
wait_for_taskWait until a task finishes and return its results.
get_taskCheck a task. Finished images are returned inline.
list_tasksList your recent tasks.
get_balanceShow available, reserved and spent credits.

Let your agent do the setup

Prefer one step? Copy the setup prompt from the Agents page into your agent; it runs these steps for you. Agents