Faxdrop Mcp
@klodr
Send real faxes from any MCP-enabled AI assistant. Wraps the FaxDrop API (PDF/DOCX/JPG/PNG, international numbers, status polling) with rate limits, dry-run mode, audit logging, outbox jail, and 3-layer phone gate (TYPE → COUNTRY → per-number pairing).
Overview
What is Faxdrop Mcp?
Faxdrop Mcp is a Model Context Protocol (MCP) server that lets AI assistants (Claude, Cursor, Continue, OpenClaw, etc.) send real faxes through the FaxDrop API. It wraps the FaxDrop hosted fax service’s HTTP API, targeting users who still need faxing for US healthcare, government forms, and legal/financial workflows.
How to use Faxdrop Mcp?
Install globally via npm install -g faxdrop-mcp or run directly with npx faxdrop-mcp. Set the FAXDROP_API_KEY environment variable (get your key at faxdrop.com/account) and configure the server in your MCP client’s mcpServers JSON. Three tools are exposed: faxdrop_send_fax, faxdrop_pair_number, and faxdrop_get_fax_status.
Key features of Faxdrop Mcp
- Input validation (absolute path, file extension, 10 MB cap)
- TOCTOU-safe file read with continuous size enforcement
- No secret leakage in error objects or audit logs
- Dry-run mode via
FAXDROP_MCP_DRY_RUN=true - JSONL audit log with
FAXDROP_MCP_AUDIT_LOG - 3-layer phone gate (type → country → paired number whitelist)
Use cases of Faxdrop Mcp
- Send signed healthcare forms directly from an AI assistant
- Deliver government document faxes without leaving a chat interface
- Automate legal/financial fax workflows with agent safeguards
- Test fax prompts safely with dry-run before real sending
FAQ from Faxdrop Mcp
How do I get a FaxDrop API key?
Sign up at faxdrop.com/account to obtain your key. Set it as the FAXDROP_API_KEY environment variable when running the server.
Can I test faxing without actually sending a fax?
Yes. Set the environment variable FAXDROP_MCP_DRY_RUN=true to simulate sending and validate prompts without incurring cost.
What file formats and size limits are supported?
You can send PDF, DOCX, JPG, and PNG files up to 10 MB. The server validates the file extension and size before opening the file.
Is there a free tier available?
Yes, FaxDrop offers a free tier that includes 2 faxes per month.
How does the phone gate security work?
The server enforces a three-layer whitelist: fax type, country, and per-number pairing. Numbers must be added via the faxdrop_pair_number tool (human-in-the-loop approval) before they can be used.
