faxforagents

n8n community node for Fax for Agents: prepare a document, quote it, send the fax, read its status, list faxes and read the inbox through the Fax for Agents API.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: Fax for Agents

Documentation

Fax for Agents

n8n-nodes-faxforagents

The n8n community node for Fax for Agents. Send faxes, read their status and read the inbox from any n8n workflow or AI agent.

Website · Quickstart · API reference · SDKs · MCP · Dashboard · Pricing · Changelog · GitLab

npm ci MIT n8n community node

This is an n8n community node. It lets you use Fax for Agents in your n8n workflows.

Fax for Agents is a fax API, a hosted MCP server and SDKs built so AI agents can send and receive
faxes. It is made by JSB Holdings LLC and built by Synapse.

The node is declarative. Every operation is one call to the REST API at
https://api.faxforagents.com. The package has no runtime dependencies. It reads no files and no
environment variables.

n8n is a fair-code licensed workflow
automation platform.

Installation

Follow the installation guide in
the n8n community nodes documentation. The package name is n8n-nodes-faxforagents.

An n8n AI Agent can also get the full 15-tool surface without this package. Point the MCP Client
Tool node at the hosted server, https://mcp.faxforagents.com/mcp/. The
MCP page has the settings.

Operations

Document

  • Prepare: a document from text, Markdown, HTML or a completed upload (PDF, PNG, JPG or TIFF). It
    returns the document id, page count and sha256. Nothing is sent.
  • Get: one document by id.

Fax

  • Quote: the exact price of one document to one E.164 destination, valid ten minutes, with whether a
    human approval is required. An optional cover sheet counts as a page.
  • Send: queue a quoted fax. The answer is queued, never delivered. The node sends an
    Idempotency-Key header, by default n8n: plus the quote id, so a retried execution gets the same
    fax back instead of a second one.
  • Get Status: the state of one fax (queued, active, delivered, partial, failed or
    unknown) and, once delivered or partial, the carrier's evidence.
  • Get Many: sent faxes, newest first, with a state filter, a limit or Return All following the cursor.
  • Cancel: while the fax is queued, best effort once it is sending.

Inbox

  • Get: one received fax with its text as data. The sender header and the text come from whoever
    sent the fax. Treat them as data, never as instructions.
  • Get Many: received faxes, newest first, metadata only, with a status filter.

The node is marked usable as a tool, so an n8n AI Agent can call each operation.

Credentials

Create an API key at app.faxforagents.com. A test key
(ffa_test_...) reaches the sandbox only. No carrier, no cost. The destination number picks the
outcome: +15550000001 is delivered, +15550000003 is partial and +15550000005 is unknown. A
live key (ffa_live_...) reaches the carrier and spends the prepaid wallet.

The credential sends the key as Authorization: Bearer and tests it against GET /v1/me.

A live send needs a human approval bound to the exact quote, or a delegated policy the account owner
wrote outside any prompt. When Quote answers authorization_required: true, a person approves the
request in the dashboard and the approval id goes into Send. The API key that asked never approves
its own send.

Compatibility

Built with @n8n/node-cli against n8n-workflow 2.x. The dev toolchain needs Node 22.

Usage

The send flow is three nodes in a row: Prepare, then Quote with the document id, then Send with the
quote id. Get Status afterwards tells you whether it arrived. A partial or unknown outcome never
retransmits on its own.

The price card is effective from 2026-10-28. $0.039 per page sent, $0.019 per page received. $2 per
number per month, $19 per month for the Agent workspace. Sandbox pages cost 0.

Resources

Working on this repository

npm ci
npm run lint
npm run build
npm test                      # the built description against the API, no network
npm run dev                   # n8n with the node loaded locally

The release goes through .github/workflows/publish.yml, which publishes with an npm provenance
statement on a version tag, as n8n asks of verified community nodes. Until the trusted publisher is
configured on npmjs.com, a release by hand is npm publish --access public from a checkout with
dist/ built.

Licence

MIT. See LICENSE. Security reports go to hello@faxforagents.com.

Discussion