Fax for Agents
Menu
Documentation Screenshot guides

Send a fax from Claude Code

Updated

Claude Code can send and read faxes for you through the Fax for Agents tool server. You describe the fax in plain words. Claude Code prepares the page, gets a quote and sends it. 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.
  • Claude Code with the Fax for Agents tool server connected. Run claude mcp add --transport http faxforagents "https://mcp.faxforagents.com/mcp/?auth=required", then /mcp, choose faxforagents and Authenticate. Allow the connection in the browser and keep the box "Let this app send faxes within your limits without asking" ticked.
  • The Connected apps switch in Settings is on by default. The default limits are $5.00 per fax and 20 faxes a day.

1.Open Claude Code

Open Claude Code in the folder you work in. The tool server is already connected, so you can start typing.

Claude Code open in a terminal, in the demo folder, waiting for a prompt.
Open Claude Code in your project. Fax for Agents is connected as a tool server.

2.Allow the fax tool

Type what the fax should say and where it goes. Claude Code asks once before it runs a tool.

Claude Code asks for permission to run the Prepare fax tool, with the option Yes, and don't ask again.
Choose "Yes, and don't ask again" for the faxforagents Prepare fax commands. Claude Code remembers it for this folder.

3.Read the quote

Claude Code prepares a one page document from your words and asks for a quote. Nothing is sent yet.

The quote: one page to +15550000001, $0.000 in Sandbox, with the policy line allow, no approval required.
The quote shows the destination, the pages, the price and the policy line "allow, no approval required". Claude Code adds "The quote allows auto-send".

4.Send it

Say "Send it." The send goes through at once because the quote is inside your limits.

Claude Code reports the fax as delivered, 1 of 1 pages, with the carrier reference and the remote station SBX-OK.
Claude Code reports Delivered with the carrier evidence.

5.Check the evidence

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

A table of the delivery evidence: provider, reference, remote station, pages sent, timestamps, hashes, policy version.
The evidence lists every page, every attempt and the policy version the fax went out under.

6.Read the inbox

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

Claude Code lists the inbox and prints the text of the newest received fax from +15550000042, two pages.
Claude Code 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 Claude Code 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 Claude Code 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 Claude Code to send.

The full routine is in Approve every fax from Claude Code.

Troubleshooting

  • The quote says "deny" 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.
  • Claude Code asks "Do you want to proceed?" before each tool. That is Claude Code's own permission prompt. Choose Yes, or the "don't ask again" option to allow that tool in this folder.
  • /mcp shows faxforagents with "tools fetch failed" or "not authenticated". Choose the server, then Authenticate, and allow the connection in the browser again.
  • Claude Code starts a shell command to wait for an approval. Tell it to stop and report the request id instead. You tell it when the person has decided.

Next