GotFreeFax

Send a fax to a US or Canada phone number. Accepts PDF, DOC, DOCX, JPG, JPEG, TXT files (max 10) as base64-encoded content.

{
  "type": "object",
  "properties": {
    "fax_number": {
      "type": "string",
      "description": "Destination fax number (10 digits, US or Canada)"
    },
    "files": {
      "type": "array",
      "description": "Array of files to fax",
      "items": {
        "type": "object",
        "properties": {
          "filename": {
            "type": "string",
            "description": "File name with extension (e.g. document.pdf)"
          },
          "content": {
            "type": "string",
            "description": "Base64-encoded file content"
          }
        },
        "required": [
          "filename",
          "content"
        ]
      }
    },
    "notify_url": {
      "type": "string",
      "description": "Optional URL to receive fax completion notification"
    }
  },
  "required": [
    "fax_number",
    "files"
  ]
}

Check the delivery status of a previously sent fax using its job_id. No authentication required — the job_id is the unforgeable token.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job ID returned by send_fax"
    }
  },
  "required": [
    "job_id"
  ]
}

Get the current page balance and dollar amount balance for the authenticated account.

{
  "type": "object",
  "properties": {},
  "required": []
}

List faxes previously sent by the authenticated account (most recent first). Includes faxes sent via MCP, REST API, and the prepaid web form. Free anonymous sends are not included.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max records to return (1-100, default 20)"
    },
    "offset": {
      "type": "integer",
      "description": "Skip first N records for pagination (default 0)"
    }
  },
  "required": []
}

Start a prepaid credit purchase. If the request is authenticated, credits will be loaded into the authenticated account after PayPal payment. If the request is not authenticated, provide email and name to create a new prepaid account (or load credits into an existing one with the same email). Returns a PayPal payment URL the user must visit to complete the purchase.

{
  "type": "object",
  "properties": {
    "service_type": {
      "type": "string",
      "description": "Purchase option. One of: prepaid10 (100 pages, $9.95), prepaid20 (250 pages, $19.95), prepaid50 (800 pages, $49.95), intprepaid50 ($49.95 international balance), intprepaid100 ($99.95 international balance), intprepaid200 ($199.95 international balance)."
    },
    "email": {
      "type": "string",
      "description": "Required when the request is not authenticated. Used to create or load an existing prepaid account."
    },
    "name": {
      "type": "string",
      "description": "Required when the request is not authenticated. Account holder name."
    }
  },
  "required": [
    "service_type"
  ]
}

Send a free fax to a US or Canada number (no account required). Limited to 3 pages total and 2 sends per email/IP per day. Returns a job_id immediately, but the fax does NOT send until the sender clicks a confirmation link emailed to sender_email. The daily-limit check happens at click time, not at submission — a submitted fax may still be rejected if the limit is hit by then; the agent can detect this by calling check_fax_status after the user reports clicking the link. If the document exceeds the free page limit, the response will suggest using purchase_credits to buy a prepaid account.

{
  "type": "object",
  "properties": {
    "fax_number": {
      "type": "string",
      "description": "Destination fax number (10 digits, US or Canada)."
    },
    "sender_name": {
      "type": "string",
      "description": "Sender's name (required)."
    },
    "sender_email": {
      "type": "string",
      "description": "Sender's email address. A confirmation link will be sent here; the fax does NOT actually send until the user clicks that link."
    },
    "receiver_name": {
      "type": "string",
      "description": "Receiver's name (required)."
    },
    "sender_company": {
      "type": "string",
      "description": "Sender's company (optional)."
    },
    "sender_fax": {
      "type": "string",
      "description": "Sender's fax number (optional)."
    },
    "receiver_company": {
      "type": "string",
      "description": "Receiver's company (optional)."
    },
    "subject": {
      "type": "string",
      "description": "Subject line (optional)."
    },
    "text": {
      "type": "string",
      "description": "Fax body text. Either text or files must be provided."
    },
    "files": {
      "type": "array",
      "description": "Up to 3 files. Each must be base64-encoded. Free faxes are limited to 3 pages total across text + files.",
      "items": {
        "type": "object",
        "properties": {
          "filename": {
            "type": "string"
          },
          "content": {
            "type": "string",
            "description": "Base64-encoded file content"
          }
        },
        "required": [
          "filename",
          "content"
        ]
      }
    },
    "cover_sheet": {
      "type": "boolean",
      "description": "Include cover sheet (default true)."
    }
  },
  "required": [
    "fax_number",
    "sender_name",
    "sender_email",
    "receiver_name"
  ]
}

List all supported file formats that can be faxed.

{
  "type": "object",
  "properties": {},
  "required": []
}