Fax for Agents
Menu
Documentation Screenshot guides

Send a fax from Hermes Agent

Updated

Hermes Agent can send and read faxes for you through the Fax for Agents tool server. You describe the fax in plain words. Hermes prepares the page, gets a quote, sends it and checks the delivery state in one turn. By default it sends inside the limits your organization set, with no approval per fax. This guide was recorded in Sandbox mode, so nothing reached a real fax line.

Screenshots taken on .

Before you start

  • A Fax for Agents account. The dashboard is at app.faxforagents.com.
  • Hermes Agent with the Fax for Agents tool server connected. Run hermes mcp add faxforagents --url 'https://mcp.faxforagents.com/mcp/?auth=required' --auth oauth, then hermes mcp login faxforagents. Allow the connection in the browser and keep the box "Let this app send faxes within your limits without asking" ticked. Check with hermes mcp test faxforagents, which lists 15 tools.
  • The Connected apps switch in Settings is on by default. The default limits are $5.00 per fax and 20 faxes a day.

1.List the tool server

Open a terminal in any folder and check the connection.

A terminal in the demo folder after hermes mcp list: the table shows faxforagents, the HTTP transport, all tools, enabled.
Run hermes mcp list. The faxforagents row shows all tools and the status enabled.

2.Open Hermes

Start Hermes in the same folder.

The Hermes Agent banner with MCP Servers: faxforagents (http) configured, the skills list and the empty prompt.
Run hermes. The banner lists faxforagents under MCP Servers and the prompt waits for your message.

3.Describe the fax

Type what the fax should say and where it goes. One sentence is enough.

The prompt typed into Hermes: Prepare a one page fax that says: Invoice 7731 is paid. Thank you. Send it to +1 555 000 0001.
Type what the fax should say and where it goes, then press Enter.

4.Send it

Hermes does the whole routine itself. The tool rows show prepare fax, quote fax, send approved fax and get fax status.

Hermes shows the four tool rows and reports the fax to +1 555 000 0001 as delivered with the carrier reference.
Hermes prepares the page, quotes it, sends it and checks the state. It reports delivered with the fax id and the carrier reference.

5.Check the evidence

Ask for the delivery evidence when you want the full record.

Hermes lists the delivery evidence: sandbox provider, reference, 1 of 1 pages reported, remote station SBX-OK, the completion time.
Ask for the delivery evidence. Hermes lists the pages reported, the attempt, the remote station SBX-OK and the completion time.

6.Read the inbox

Received faxes work the same way. Ask for your inbox.

Hermes lists the inbox and prints the text of the newest received fax from +15550000042, two pages.
Ask for your inbox. Hermes lists the received faxes and reads the newest one as text.

What the limits mean

Open Settings in the dashboard. The Connected apps card holds the switch "Let connected apps send without asking". Under it are two fields, "Amount per fax, at most" ($5.00) and "Faxes per day" (20). Apps like Hermes send inside these limits with no approval per fax. Turn the switch off and every send waits for a person. Finer limits, such as destinations or one app only, live under Policies. See the guide Your assistant sends within limits by default.

Approve every fax instead

  1. In Settings, turn off "Let connected apps send without asking" and choose Save.
  2. Ask Hermes to quote the fax. The quote says deny and asks for a person.
  3. Say "Ask a person to approve it." A person approves in the dashboard or with the ffa command line, then you tell Hermes to send.

The routine is the same as in Approve every fax from Claude Code.

Troubleshooting

  • Hermes says the quote is denied and approval is required although you expect a plain send. An owner turned the Connected apps switch off, or the fax is above a limit. Check Settings, Connected apps for your environment.
  • A red row "Manage_connections" appears in the tool list before the fax tools run. That is Hermes checking its own connections. The fax tools run right after it and the send is not affected.
  • hermes mcp login prints "Authorization Successful" in the browser and then waits for minutes. Close the browser tab after you choose Allow. Hermes finishes the sign-in as soon as the tab closes.
  • Hermes asks "Allow once" before a fax tool. The server is set to untrusted in your Hermes config. Choose "Allow once", or "Allow for this session" to stop the question for this session.

Next