Faxdrop Mcp
About
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).
Details
- Author
- klodr
- Downloads
- 276
- Categories
- Other
Jump to
- 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)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Faxdrop McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"faxdrop mcp": {
"faxdrop": {
"command": "npx",
"args": [
"-y",
"faxdrop-mcp"
],
"env": {
"FAXDROP_API_KEY": "fd_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
}McpServers
{
"faxdrop": {
"command": "npx",
"args": [
"-y",
"faxdrop-mcp"
],
"env": {
"FAXDROP_API_KEY": "fd_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}faxdrop-mcp
Send real faxes from any MCP-enabled AI assistant. Wraps the FaxDrop HTTP API. A Model Context Protocol (MCP) server that lets AI assistants (Claude, Cursor, Continue, OpenClaw…) send real faxes through the FaxDrop API.Why this MCP?
Faxing is still required by US healthcare, government forms, and a long tail of legal/financial workflows. FaxDrop is a hosted fax service with a clean HTTP API and a free tier (2 faxes/month). This MCP exposes it to LLMs with the safeguards an agent platform actually needs.Features
- Input validation — absolute-path + extension + 10 MB cap on the upload (all before the file is opened); E.164 regex on the fax number; no SSRF, no path traversal. - TOCTOU-safe read — file descriptor pinned withfs.open(), size enforced continuously while reading.
- No secret leakage — error objects strip the response body; audit log redacts apiKey/authorization/password/etc.
- Dry-run + audit log — FAXDROP_MCP_DRY_RUN=true to test prompts without sending; FAXDROP_MCP_AUDIT_LOG=/abs/path for a JSONL trail (mode 0o600).
- 3-layer phone gate — TYPE → COUNTRY → per-number pairing whitelist.
- Verifiable releases — Sigstore-signed + SLSA in-toto attestation + npm provenance.
Installation
``bash
npm install -g faxdrop-mcp
`
Or directly via npx:
`bash
npx faxdrop-mcp
`
Configuration
The server reads FAXDROP_API_KEY from the environment. Get your key at faxdrop.com/account.
`json
{
"mcpServers": {
"faxdrop": {
"command": "npx",
"args": ["-y", "faxdrop-mcp"],
"env": {
"FAXDROP_API_KEY": "fd_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
``
Tools (3)
- faxdrop_send_fax — send a fax from a local document (PDF/DOCX/JPG/PNG, ≤10 MB) to an E.164 number. - faxdrop_pair_number — add a fax number to the paired whitelist (HITL approval). - faxdrop_get_fax_status — check delivery status of a previously sent fax.License
MITSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
