faxdrop_send_fax
Send a real fax to a fax number using a document from the outbox. Supports PDF, DOCX, JPEG, and PNG files with an optional cover page.
Instructions
Send a real fax via FaxDrop.
USE WHEN: user needs to fax a document (PDF, DOCX, JPEG, PNG ≤10MB) to a fax number — medical records, legal forms, government submissions, recipients who only accept fax.
DO NOT USE: for digital delivery (email, sftp), for files outside the outbox, for non-fax numbers — the 3-layer phone gate (TYPE → COUNTRY → per-number policy) rejects mobile/landline/premium.
SIDE EFFECTS: charges FaxDrop balance (or consumes free credits + adds branded cover on free tier), creates an audit log entry, allocates a fax ID server-side. ALWAYS confirm recipient + file + cover with the user before calling.
FILE LOCATION: document must live inside the outbox (default ~/FaxOutbox/, override via FAXDROP_MCP_WORK_DIR). Files outside are rejected — ask the user to copy in first.
RETURNS: { faxId, status: "queued", ... } — poll with faxdrop_get_fax_status.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filePath | Yes | Absolute path to the document to fax (PDF, DOCX, JPEG, or PNG, ≤10MB). | |
| recipientNumber | Yes | Recipient fax number, international (E.164) format with leading + and country code, e.g. +12125551234 | |
| senderName | Yes | Sender display name shown on the cover page. | |
| senderEmail | Yes | Sender email for delivery confirmation. | |
| includeCover | No | Include a FaxDrop cover page. Free accounts always include a branded cover regardless; paid accounts default to false. The cover-page fields below (coverNote, recipientName, subject, senderCompany, senderPhone) are only printed when includeCover is true. | |
| coverNote | No | Message printed on the cover page (max 500 chars). Only used when includeCover is true. | |
| recipientName | No | Recipient display name on the cover page, e.g. "Dr. Jane Smith" (max 50 chars). | |
| subject | No | Cover page subject / RE: line (max 200 chars). | |
| senderCompany | No | Sender company shown on the cover page (max 100 chars). | |
| senderPhone | No | Sender callback number shown on the cover page (E.164 format). |