Hermes Agent skill and MCP setup
Give Hermes Agent a real US number for verification codes, eSIM data for a trip and a mobile IP by country. Install the VoidMob skill from its well-known address or add the MCP server to config.yaml.
- US numbersNumbers
- $0.15/code
- Dedicated numbersDedicated
- $16.99/mo
- eSIM planseSIM
- $3.49from
- Mobile proxiesProxies
- $3.99/GB
$ hermes skills install well-known:https://voidmob.com/.well-known/skills/voidmob # ~/.hermes/.envVOIDMOB_API_KEY=vmk_live_... # ~/.hermes/config.yamlterminal: env_passthrough: [VOIDMOB_API_KEY]Then ask Hermes Agent
What's my VoidMob balance?A number back means the key and the install both work.
Install from the full well-known address, not the voidmob.com/skill.md short link: Hermes looks for the skill's reference files next to the address you give it. env_passthrough lets the key into the curl calls Hermes runs.
What VoidMob adds to Hermes Agent
Hermes Agent is Nous Research's open-source, self-improving agent. It runs on a laptop, a small VPS or a serverless backend, installs Agent Skills from GitHub or a well-known URL, and connects MCP servers declared in config.yaml.
Verification codes on request
Hermes rents a US non-VoIP number for the service you name, waits for the SMS and reads you the code, all inside the session. It quotes the price first and rents once you agree.
SMS verificationTravel data it can shop for
Give it a destination, dates and how much data you use. It compares eSIM plans, buys the one you pick and returns the QR code and LPA string for your phone.
eSIM data plansA mobile IP for the jobs it writes
Hermes documents no way to point its local browser at your own proxy, so the proxy goes into the work: a proxy list login in the scripts it writes, or curl -x, for research and price checks that need a carrier IP in a given country.
Proxies for AI agentsA number your app's tests can keep
One-time numbers cover listed services. To test your own app's SMS login, give Hermes a dedicated monthly number: it receives SMS from any sender, so its test runs can read every code your app sends.
Dedicated numbersSet up VoidMob in Hermes Agent
One step is yours whichever path you take: create an API key in the dashboard and top up the balance with crypto.
Create a key and fund the balance
Create a key under Developers, API Keys (it is shown once) and top up with crypto. The balance is the most Hermes can ever spend.
Install the skill or add the server
Run the skill install, or paste the
mcp_serversblock into~/.hermes/config.yaml. Its sandbox variant needs no key: the quickest way to see the tools first.Put the key in ~/.hermes/.env
Hermes reads
${VOIDMOB_API_KEY}from the active profile's.env. For the skill, also list it underterminal.env_passthrough: Hermes cleans its terminal's environment.Choose what runs without a prompt
Smart approvals let ordinary calls run unless Hermes judges them risky. For a prompt on every purchase, set
trust: untrustedon the voidmob server.Ask for the balance
Start a new session and ask Hermes for your VoidMob balance. A number back means the key, the install and the connection all work.
A first task to try
Paste this to Hermes Agent. The panel plays what the setup above makes happen.
Find eSIM plans for five days in Japan with at least 5 GB. Show me the two best matches with their prices and wait for my pick.Two fit five days: 5 GB for 15 days at $6.99, or 10 GB for 30 days at $9.49. Both are 5G. Which one?
Japan · 5 GB · 15 days · 5G
Scan it in your phone's eSIM settings, or enter the LPA string by hand
Scan it before you fly. Most plans start counting days when the eSIM first connects.
Most plans start counting days when the eSIM first connects, so buying early does not shorten the trip. Hermes can check data used later with get_esim_status.
Checks before every charge
Two checks always run at VoidMob: the price you approved and your balance. Two more run inside your MCP server when you set them. A refusal at any of them charges nothing.
No SMS, no charge
A verification number stays open 15 minutes. If no SMS arrives, the price returns to the balance automatically, except on services marked non-refundable.
Keys you can pull
Give Hermes Agent its own key and revoke it on the API Keys page whenever you like. It stops working at once.
Per-order limitIn your MCP server, when set
VOIDMOB_MAX_ORDER_CENTS=2500
$6.99 is under the $25.00 limit (passed)
Session budgetIn your MCP server, when set
VOIDMOB_BUDGET_CENTS=5000
$6.99 of $50.00 left (passed)
Price you approvedAt VoidMob, always
max_price_cents
Live $6.99, approved $6.99 (passed)
Your balanceAt VoidMob, always
prepaid, topped up by you
$42.10 covers it (passed)
When Hermes Agent and VoidMob disagree
The skill installs but its reference files are missing
It was installed from the voidmob.com/skill.md short link, so Hermes looked for the references next to that address.
Fix
Reinstall from
well-known:https://voidmob.com/.well-known/skills/voidmob, which keeps the skill and its references together.curl calls to the API come back unauthorized
Hermes runs terminal commands in a cleaned environment and the key was not passed through.
Fix
Add
VOIDMOB_API_KEYtoterminal.env_passthroughinconfig.yamland start a new session.The MCP server never starts
The VoidMob MCP server needs Node 22 or newer, and the backend Hermes runs in may not ship it.
Fix
Run
node -vin that backend and install Node 22 or newer, or use the skill path, which only needs curl.
Give Hermes Agent a balance to draw on
Create an API key, top it up with crypto, and paste it where the setup above says. Prefer to look first? The MCP server runs on play money with no key.
Frequently Asked Questions
Common questions about VoidMob in Hermes Agent.
hermes skills install well-known:https://voidmob.com/.well-known/skills/voidmob, or the GitHub form hermes skills install voidmobcom/voidmob-mcp/skills/voidmob. Put VOIDMOB_API_KEY in ~/.hermes/.env and list it under terminal.env_passthrough so the skill's curl calls receive it.mcp_servers in ~/.hermes/config.yaml with the command, args and env. VoidMob's server runs locally over stdio through npx, and its sandbox variant uses play money with no key.VOIDMOB_MAX_ORDER_CENTS and VOIDMOB_BUDGET_CENTS to the server's env; for a prompt on each purchase, set trust: untrusted on the voidmob server, and Hermes asks before every tool not marked read-only.curl -x, which suits research and price checks that need a carrier IP in a given country.Based on Hermes Agent's own docs: Skills · MCP · MCP config reference · GitHub repository. Last checked .