Skip to main content

​
Fax.Plus MCP Server

The Fax.Plus MCP Server lets AI assistants send and receive faxes, manage contacts, track delivery, and configure webhooks through the Model Context Protocol (MCP) — an open standard for connecting AI tools to external services.
Beta — The Fax.Plus MCP Server is currently in beta. Features, tool schemas, and authentication flows may change. Report issues to support@alohi.com.
Enterprise plan required — Access to the Fax.Plus API requires a Fax.Plus Enterprise plan. The API is not available on Free, Premium, or Business plans.

​
MCP server URL

https://apidoc.fax.plus/mcp

​
What you can do

The Fax.Plus MCP Server enables AI assistants to interact with your Fax.Plus account using natural language. Here’s what’s supported:
CapabilityDescription
Send faxesUpload a document and send it to any fax number worldwide
Receive faxesCheck your inbox for incoming faxes, filter by date or sender
Track deliveryMonitor outbox status and get real-time delivery confirmations
Manage contactsList, create, update, and organize fax contacts and groups
Manage numbersView assigned fax numbers, status, and notification settings
Corporate accountsList and manage corporate team members (admin only)
WebhooksConfigure webhooks for real-time fax event notifications
File uploadsUpload documents for faxing (PDF, TIFF, DOC, and more)

​
Prerequisites

Before connecting, make sure you have:
  1. An active Fax.Plus Enterprise plan — View pricing
  2. A Personal Access Token (PAT) or OAuth 2.0 credentials — How to create a PAT
  3. At least one fax number assigned to your account

​
Authentication

​
Personal Access Tokens (PAT)

PATs provide secure, fine-grained access to the API. Create them from your Fax.Plus dashboard:
1

Open Integrations

Log in to your Fax.Plus account and go to Settings → Integrations.
2

Manage tokens

Under Fax.Plus API, find Personal Access Tokens and click Manage.
3

Create and configure

Create a new token and select the appropriate scopes for your use case.
4

Copy your token

Copy the token immediately — it won’t be shown again.

​
Available scopes

ScopeAccess
fax:all:readRead-only access to all fax operations
fax:all:editFull access to all fax operations
fax:webhook:readView webhook configurations
fax:webhook:editCreate and manage webhooks
fax:fax:readView and list faxes, outbox, files, reports
fax:fax:editSend faxes, manage outbox and files
fax:shop:readView available fax numbers for purchase
fax:shop:editPurchase and provision fax numbers
fax:user:readView the current user’s account details (PAT owner)
fax:user:editUpdate the current user’s account details (PAT owner)
fax:member:readView corporate member details
fax:member:editUpdate corporate member settings
fax:numbers:readList and view assigned fax numbers
fax:numbers:editManage and configure fax numbers
fax:ai:readRead access to AI-powered fax features
fax:ai:editManage AI-powered fax features
fax:ai_settings:readView AI feature settings and configuration
fax:ai_settings:editUpdate AI feature settings and configuration
For most use cases, fax:all:read and fax:all:edit provide the access you need. Use granular scopes when you want to restrict what the integration can do.

​
Connecting to an MCP client

The Fax.Plus MCP Server works with any client that supports the Model Context Protocol. Below are setup instructions for common environments.

​
Generic MCP configuration

Point your MCP client to the Fax.Plus server URL and pass your authentication token: 
{
  "mcpServers": {
    "faxplus": {
      "type": "url",
      "url": "https://apidoc.fax.plus/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
}

​
Using with the Anthropic API (MCP Connector)

import anthropic

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    betas=["mcp-client-2025-11-20"],
    mcp_servers=[
        {
            "type": "url",
            "url": "https://apidoc.fax.plus/mcp",
            "name": "faxplus",
            "authorization_token": "YOUR_PERSONAL_ACCESS_TOKEN",
        }
    ],
    messages=[
        {"role": "user", "content": "Check my fax inbox for anything received today"}
    ],
)

​
Using with OpenAI Agents SDK

from openai_agents import Agent, MCPServerSse

faxplus_server = MCPServerSse(
    url="https://apidoc.fax.plus/mcp",
    headers={"Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"},
)

agent = Agent(
    name="Fax Assistant",
    instructions="Help the user send and receive faxes.",
    mcp_servers=[faxplus_server],
)
Replace YOUR_PERSONAL_ACCESS_TOKEN with the PAT you created in the Authentication section.

​
Available tools

The Fax.Plus MCP Server exposes the following tools to connected AI assistants.

​
Faxes

ToolDescription
list_faxesList received faxes with optional filters (date, sender, status)
get_faxGet details of a specific fax by ID
download_faxDownload a received fax file
send_faxUpload a document and send it to one or more fax numbers
list_outboxList queued and in-progress outgoing faxes
get_outbox_itemCheck the delivery status of a specific sent fax
delete_outbox_itemCancel a queued fax

​
Files

ToolDescription
upload_fileUpload a document for faxing (PDF, TIFF, DOC, DOCX, XLS, XLSX, and more)

​
Contacts

ToolDescription
list_contactsList all fax contacts with optional search
create_contactAdd a new fax contact
update_contactUpdate an existing contact’s details
delete_contactRemove a contact

​
Numbers

ToolDescription
list_numbersList all fax numbers assigned to the account
get_numberGet details and settings for a specific number

​
Accounts

ToolDescription
get_accountGet the current user’s account information
list_membersList all corporate team members (admin only)
update_memberUpdate a team member’s settings (admin only)

​
Webhooks

ToolDescription
list_webhooksList configured webhook endpoints
create_webhookRegister a new webhook for fax events
delete_webhookRemove a webhook endpoint

​
Usage examples

Once connected, you can interact with Fax.Plus through natural language. Here are some common workflows.

​
Send a fax

You: Send the attached contract to +1-212-555-0199 Assistant: I’ve uploaded your contract and sent it to +1-212-555-0199. The fax was delivered successfully — 3 pages, transmitted in 12 seconds. The fax ID is abc123def.

​
Check your inbox

You: Did I receive any faxes today? Assistant: You received 2 faxes today:
  1. From +1-415-548-5563 at 9:38 AM — 23 pages, status: success
  2. From +1-312-555-0142 at 2:15 PM — 1 page, status: success

​
Track delivery

You: Did my fax to the courthouse go through? Assistant: Yes — your fax to +1-218-413-7255 was delivered successfully at 12:14 PM today. 2 pages, 2 seconds transmission time.

​
Manage contacts

You: Show me all my fax contacts in the Office group Assistant: You have 1 contact in the “Office_ch” group: Alohi Fax Machine near Scott, fax number +41 22 794 3479.

​
List fax numbers

You: What fax numbers do I have? Assistant: You have one active fax number: +1-419-548-5563, acquired October 8, 2024, with email and push notifications enabled.

​
API reference

The MCP Server is built on the Fax.Plus REST API v3. For detailed endpoint documentation, schemas, and error codes:

API Documentation

Full endpoint reference with request/response examples

Quickstart Guide

Get up and running with the Fax.Plus API in minutes

Authentication

OAuth 2.0 and PAT setup guides

Help Center

FAQs, troubleshooting, and how-to articles

​
SDKs

LanguagePackage
Node.js@alohi/faxplus-api
Pythonfaxplus-api

​
Security and compliance

Fax.Plus is built with enterprise-grade security and meets strict regulatory requirements:
  • Encryption: AES-256 at rest, TLS 1.3+ in transit
  • Certifications: ISO 27001, SOC 2 Type 2, HIPAA (with BAA), PCI DSS
  • Compliance: GDPR, CCPA, eIDAS
  • Access control: SSO, 2FA, role-based permissions, fine-grained PAT scopes
  • Data residency: Flexible options across multiple regions
  • Audit trails: Complete logging of all fax activity
For HIPAA-compliant faxing workflows, see Fax.Plus HIPAA.

​
Limitations

Current beta limitations
  • Enterprise plan required — The Fax.Plus API is only available on Enterprise plans.
  • No account creation via API — New user accounts must be created through the Fax.Plus web dashboard. The API supports managing existing accounts only.
  • No public sandbox — Contact support@alohi.com to request a test environment.
  • File size limits — Uploaded files are subject to size limits. Large documents should be split before uploading.
  • Rate limits — API requests are rate-limited. See the API documentation for current thresholds.
  • Fax delivery — Transmission success depends on the recipient’s fax machine availability and line quality. Automatic retries can be configured when sending.

​
Troubleshooting

​
”Invalid token” or 401 Unauthorized

Your PAT may have expired or lacks the required scopes. Generate a new token from Settings → Integrations → Personal Access Tokens in your Fax.Plus dashboard. Ensure the token includes at least fax:all:read for read operations and fax:all:edit for sending faxes.

​
Fax stuck in outbox or delivery failed

Check that the recipient’s fax number is in E.164 format (e.g., +12125550199). Verify the number is a working fax line. You can configure automatic retries with the retry parameter when sending.

​
403 Forbidden on member endpoints

Only corporate admin accounts can access member management endpoints. Verify your account has the corporate_admin role.

​
Getting help