# Faxforagents MCP

> Faxforagents MCP is a paid MCP server for communication. Send and receive faxes from an AI agent, with quotes, approvals and delivery proof. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI
- **Website:** https://faxforagents.com
- **Repository:** https://github.com/faxforagents/mcp
- **MCP Registry name:** io.github.faxforagents/faxforagents-mcp
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

Fax for Agents is built around the idea that a fax is a paid, hard-to-undo action, so the agent works inside limits you set. A job runs through prepare, quote, approve, send, receive and reconcile. The quote binds the document, destination, sender and amount for ten minutes, and a person approves that exact send or a pre-written policy allows it. Any change to the document voids the approval, and approvals and budgets are checked on the server, never from prompt text.

Every job ends in one of six states: queued, active, partial, failed, unknown or delivered. The word delivered is written only when the carrier provides evidence on the attempt, and the receipt records the page count, provider reference, document sha256 and amount captured. Received faxes sit in a private inbox behind signed URLs, and their text is flagged as untrusted data on every result.

The hosted server at mcp.faxforagents.com exposes 17 tools, and the npm package implements the same names over stdio. A free sandbox with test keys lets you rehearse each outcome, from delivered to unknown, before real money moves. Documents are kept 30 days by default and processed in the EU.

## Features

- **Quote before send:** A ten-minute quote binds the document, destination, sender and price.
- **Exact-send approval:** A person or a pre-set policy approves; any document change voids it.
- **Delivery evidence:** Delivered is recorded only with the provider's evidence, plus a receipt.
- **Private inbox:** Received faxes are kept behind signed URLs and marked as untrusted text.
- **Free sandbox:** Test keys reproduce every outcome without a carrier or cost.
- **Hosted or stdio:** Use the hosted server or the npm package with the same 17 tool names.

## Good for

- Let an agent fax a signed PDF to a clinic or office
- Receive faxes into an inbox an agent can read
- Rehearse failed and partial deliveries in the sandbox
- Cap an agent's fax spending with a prepaid wallet
- Keep an audit record of each fax sent

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http faxforagents-mcp https://mcp.faxforagents.com/mcp/
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.faxforagents.com/mcp/
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "faxforagents-mcp": {
      "url": "https://mcp.faxforagents.com/mcp/"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "faxforagents-mcp": {
      "type": "http",
      "url": "https://mcp.faxforagents.com/mcp/"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "faxforagents-mcp": {
      "serverUrl": "https://mcp.faxforagents.com/mcp/"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "faxforagents-mcp": {
      "type": "http",
      "url": "https://mcp.faxforagents.com/mcp/"
    }
  }
}
```

## Tools

- `get_guide`: Read the Fax for Agents manual and tool workflow. Start here for sending, approvals, inbox, OCR, card payment and error remedies. Use get_fax_capabilities for account-specific limits and routes. Returns static text and section names without authentication, side effects or charges. Repeated reads are safe.
- `get_fax_capabilities`: Read account limits, routes, formats, prices and credential scopes. Use before preparing a fax. Use quote_fax for one send's price and policy verdict, or get_fax_balance for available funds. Returns capabilities and account identity without changes or charges. me.scopes is what this credential may do. capabilities.scopes is every scope the platform defines, not what this credential holds. extracti
- `prepare_fax`: Create a fax document from text, Markdown, HTML or a completed REST upload. Use before quote_fax. Use get_fax_document to inspect an existing document. Validates and stores a PDF, returning its id, sha256, page count and preview status. Text inputs create a new document without a replay token. Uploads are consumed once. An optional idempotency_key replays the same request for 24 hours. No sending 
- `get_fax_document`: Read one fax document and its page previews. Use the document_id from prepare_fax or read_inbound_fax. Use read_inbound_fax for received-fax metadata and OCR text. Returns page count, sha256, validation warnings and signed preview URLs. Repeated reads are safe and free, though URLs expire and can change. List documents through REST GET /v1/documents. Scope: document:read.
- `quote_fax`: Price one prepared document for one fax destination. Use after prepare_fax and before send_approved_fax. Use get_fax_capabilities for general routes and prices. Creates a quote without sending or charging. An optional idempotency_key replays the same request for 24 hours. Returns USD micro-units, billable pages, a ten-minute expiry and the policy's verdict with its first failing rule and approval 
- `send_approved_fax`: Queue one quoted outbound fax for delivery. Use after quote_fax, with approval_id when human approval is required, or under an allowing delegated policy. Use request_human_review to request approval and get_fax_status to track delivery. Consumes the quote and approval, holds wallet funds and returns the queued fax plus its idempotency key. Live delivery charges the wallet. Identical requests repla
- `get_fax_status`: Read one outbound fax's delivery state and attempts. Use after send_approved_fax or list_faxes. Use get_review_status for a human approval decision and read_inbound_fax for a received fax. Returns queued, active, delivered, partial, failed or unknown, plus carrier evidence when delivered or partial. Evidence is not legal proof of acceptance. Repeated polls are safe and free, with no send or approv
- `list_faxes`: List outbound faxes your organization sent, newest first. Use to find a fax_id, then get_fax_status for delivery attempts and evidence. Use list_inbox for received faxes on your numbers and read_inbound_fax for one received item. Returns items and next_cursor, optionally filtered by state. Pass next_cursor as cursor until null. Repeated reads are safe and free, though new faxes can change results.
- `get_fax_balance`: Read available and held wallet funds in the credential's environment. Use before sending or extraction to check funds. Use quote_fax for a send's price and get_fax_capabilities for rates. Returns balance in integer USD micro-units and top_up_url, the page where a person adds funds. Repeated reads are safe and free. It cannot top up or change funds. Scope: billing:read.
- `cancel_fax`: Request cancellation of one outbound fax. Use get_fax_status first to check delivery state. Queued cancellation releases the hold. Active cancellation contacts the carrier on a best-effort basis and cannot recall transmitted pages. Returns the fax, or not_cancelable for terminal states. Repeated active calls can contact the carrier again. Already transmitted pages remain billable. Scope: fax:cance
- `request_card_payment`: Ask a person to pay for one quoted fax by card, with no wallet balance. Use after quote_fax when the wallet does not cover the send, or when the person wants to pay for one fax only. Use send_approved_fax for a wallet send. The same authorization as send_approved_fax applies: an approval_id from get_review_status, or a delegated policy that allows the send. Paying by card replaces neither, and wit
- `get_card_payment_status`: Read one card payment order made by request_card_payment: whether a person has paid, what was charged and the fax it sent. Use get_fax_status for a wallet fax and get_review_status for a human approval decision. Returns the order with next: checkout, confirm, wait or done. While a person still has to pay or confirm, it returns status_url again, the link to give them. Once the fax was released, it 
- `request_human_review`: Ask a person to approve a quoted send or help with a fax. With quote_id, binds approval to the document hash, destination, sender, amount and expiry. Without quote_id, creates a help request with an optional fax_id. Use get_review_status to poll the human decision, then send_approved_fax after approval. Stores a request and attempts an email notification, without sending a fax or charging. Returns
- `get_review_status`: Read the human approval decision for one review request. Use after request_human_review. Use get_fax_status for outbound delivery state after sending. Returns pending, approved, rejected, revoked or expired, with approval_id for an approved, unused send request. For help requests, reports whether a person closed them. Repeated polls are safe and free. It neither decides approval nor sends a fax. S
- `list_inbox`: List received faxes on your organization's numbers, newest first. Use to find an inbox_id, then read_inbound_fax for that item's page count, document reference and available OCR text. Use list_faxes for outbound faxes you sent. Returns metadata only, with items and next_cursor. Pass next_cursor as cursor until null. Repeated reads are safe and free and do not mark items read. Scope: inbox:read.
- `read_inbound_fax`: Read one received fax with its page count, document reference and available OCR text. Choose its inbox_id with list_inbox. Use get_fax_status for outbound delivery, get_fax_document for page previews, or extract_fax_data to start OCR. Returns item metadata, latest completed OCR text and latest extraction status and fields. Repeated reads are safe and free and do not mark it read or start OCR. Send
- `extract_fax_data`: Start or retrieve OCR and optional structured field extraction for one received fax or document. Use read_inbound_fax for existing inbox text without starting work. Searches the latest five extractions for this target for a queued, running or completed match on normalized schema and confidence threshold. Reuses a match without new charges. Otherwise queues work and reserves wallet funds, billed pe

## FAQ

### What does a fax cost?

Software pays $0.039 per page sent and $0.019 per page received from a prepaid wallet, plus $2 per number per month. A person sending one fax pays $2.49 by card for up to 5 pages to the US and Canada (prices as of November 2026).

### Can I try it without paying?

Yes. A key starting `ffa_test_` reaches the sandbox only, with no carrier and no cost; the destination number picks the outcome.

### What happens without an API key?

The server starts and lists its tools and guides, and other tools answer with an invalid_token error and setup instructions.

### Where are documents processed?

Documents are private, kept 30 days by default, processed in the EU, and deletable by the owner.

### Is Faxforagents MCP free?

No. Faxforagents MCP is a paid product.

### How do I add Faxforagents MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http faxforagents-mcp https://mcp.faxforagents.com/mcp/

### What are the best alternatives to Faxforagents MCP?

The closest alternatives to Faxforagents MCP are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

## Alternatives

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/faxforagents-mcp
