faxdrop_send_fax
Send a fax directly from your documents. Attach a PDF, DOCX, JPEG, or PNG and provide a fax number to deliver to recipients who only accept fax.
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 |
|---|---|---|---|
| subject | No | Cover page subject / RE: line (max 200 chars). | |
| filePath | Yes | Absolute path to the document to fax (PDF, DOCX, JPEG, or PNG, ≤10MB). | |
| coverNote | No | Message printed on the cover page (max 500 chars). Only used when includeCover is true. | |
| sendEmail | No | Whether FaxDrop should email the sender a per-fax delivery confirmation. Defaults to **false** (suppress) — the MCP is built for batch / agent workflows where one email per fax floods the inbox, and the same information is already available via `faxdrop_get_fax_status`. Set to true to opt back into the confirmation email. Failed-fax emails, operator alerts, refunds and status pages are unaffected. The send response echoes `deliveryEmail: enabled | suppressed`. | |
| senderName | Yes | Sender display name shown on the cover page. | |
| senderEmail | Yes | Sender email for delivery confirmation. | |
| senderPhone | No | Sender callback number shown on the cover page (E.164 format). | |
| 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. | |
| recipientName | No | Recipient display name on the cover page, e.g. "Dr. Jane Smith" (max 50 chars). | |
| senderCompany | No | Sender company shown on the cover page (max 100 chars). | |
| recipientNumber | Yes | Recipient fax number, international (E.164) format with leading + and country code, e.g. +12125551234 |