How do I manage Hermes Agent from Claude Code or Codex?

Add Vavio’s MCP server to Claude Code or Codex with one command, approve access in your browser, and that client can manage your hosted Hermes Agent for you. It can buy the hosting, connect the model Hermes uses, check whether Hermes is working, read its errors and restart or repair it. It manages Hermes’s computer and setup. It doesn’t send Hermes its tasks: you still talk to Hermes directly, in its own chat or on a channel you’ve connected. Anything that needs you, such as paying, entering an API key or confirming a deletion, opens a Vavio page in your browser.

Connect Claude Code

Run these two commands in your terminal. The second one opens your browser so you can sign in to Vavio and review the access Claude Code asks for.

claude mcp add --transport http vavio https://vavio.ai/api/mcp
claude mcp login vavio

Connect Codex

One command is enough. Codex finds Vavio’s sign-in by itself and opens your browser.

codex mcp add vavio --url https://vavio.ai/api/mcp

Don’t run codex mcp login vavio straight afterwards. In Vavio’s testing that asked for a second approval and left two Codex connections. Use it only to sign in again later.

Vavio tested both clients end to end on 6 November 2026, with Claude Code 2.1.316 and Codex CLI 0.154.0. Other assistants that support remote MCP servers can connect to the same address, https://vavio.ai/api/mcp. Claude Code and Codex are the two whose whole journey Vavio has tested.

What you can ask it to do

Once connected, ask in plain words. Your client picks the right Vavio tool and tells you what came back.

You ask	What happens	Where you act
“Set me up with a hosted Hermes.”	It checks what’s on offer and gives you a Vavio checkout link.	You pay in your own browser. It never sees or enters payment details.
“Connect Hermes to OpenRouter.”	It opens a Vavio page for the key. Supported keys are OpenRouter, OpenAI API, Anthropic API, Google AI Studio and xAI API. Some provider accounts can sign in instead of using a key.	You enter the key on the Vavio page, never in the chat. Vavio checks most keys with the provider before saving them.
“Which models can Hermes use? Set one.”	It lists the models your provider offers to Hermes and sets the one you choose. If Hermes warns that a model may be expensive, it asks you first.	You choose the model.
“Is my Hermes working?”	It reads the computer, gateway, model and Hermes’s last reply, and can run Hermes’s own doctor.	Send Hermes one message if it hasn’t replied yet.
“Something’s wrong. What happened?”	It reads recent errors and logs, with secrets removed, and can restart the gateway.	You decide whether to restart.
“Rename my Hermes.”	It changes the part of the address before .vavio.ai.	Nothing more to do.
“Delete this Hermes.”	It gives you a Vavio link and repeats the warning.	Nothing is deleted until you confirm on that page. Then its files, conversations and credentials are wiped at once. Billing ends at the close of the paid period.

The working-check guide explains the status check in detail. It covers what replied, not yet and not checked mean, and what to do at each step.

A first session, step by step

This is the order Vavio’s own production test followed on 7 November 2026, run with a test discount.

1. Connect your client with the commands above and approve access.
2. Ask it to set you up with a hosted Hermes. Open the checkout link it gives you and pay. In the test, Codex bought the hosting and the computer was ready about 15 minutes after checkout.
3. Ask it to connect a model. It gives you a Vavio page for your provider key or sign-in. Once the key is saved, ask it to set the model you want.
4. Send Hermes one message, from Hermes’s chat or a connected channel. In the test, Hermes replied.
5. Ask your client whether Hermes is working. In the test, Claude Code checked the status and ran the health check.

If you’d rather type commands than ask, the Vavio CLI reads the same tools: npm i -g @vavio/cli, then vavio login and vavio status.

What it can’t do yet

• Send Hermes your tasks. The connection manages Hermes. It doesn’t chat with it. Ask Hermes directly for the work you want done, then check its result.
• Open a shell on the computer. There’s no SSH or root access, and no file-upload tool. If you need to install your own system software beside Hermes, use your own VPS. The VPS or managed hosting guide compares the two.
• Act without you where it matters. Payment, API keys and deletion always go through a Vavio page you complete yourself. That’s deliberate: your client can prepare the step, but only you can approve it.

Next step

• Already have a Vavio account? Run the connect command for your client, then ask: “Is my Hermes working?”
• Still deciding? Read what Hermes Agent costs each month, check the current terms on the pricing page and the FAQ, or create your Vavio account. No card is needed until you choose hosting.