MCP Server

Active

MIT

io.github.ictinnovations/ictfax-mcp MCP Server

io.github.ictinnovations/ictfax-mcp

List, track, and send faxes via ICTFax and ICTCore REST API.

What is the io.github.ictinnovations/ictfax-mcp MCP server?

The ictfax-mcp server is a Model Context Protocol interface to ICTFax, the open-source fax server built on ICTCore. It allows AI assistants to list and check the status of fax transmissions, and optionally upload documents and send faxes when write access is enabled.

This server connects Claude or other AI assistants to an ICTFax instance, enabling read-only fax tracking by default and optional fax sending when explicitly enabled. Use it to monitor incoming and outgoing faxes, check transmission status, and programmatically send faxes from your ICTCore-based fax server.

How to install io.github.ictinnovations/ictfax-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

ICTFAX_BASE_URL
required
ICTCore REST base URL of your ICTFax server, normally ending in /api, e.g. https://your-ictfax/api.
ICTFAX_USERNAME
required
API account email (ICTCore logs in by email).
ICTFAX_PASSWORD
required
secret
Password for the account.
ICTFAX_ACCOUNT_ID
Account id to send faxes from. Defaults to 1.
ICTFAX_MCP_ALLOW_WRITE
Unlocks uploading documents and sending faxes, which dials a real number and can cost money. When false those tools are not registered at all. Leave off unless you mean it.
ICTFAX_TIMEOUT_MS
Per request timeout in milliseconds. Defaults to 30000.
ICTFAX_TLS_INSECURE
Skip TLS certificate verification. Only for a self-signed test server.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ictfax-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictfax-mcp"
      ],
      "env": {
        "ICTFAX_BASE_URL": "<YOUR_ICTFAX_BASE_URL>",
        "ICTFAX_USERNAME": "<YOUR_ICTFAX_USERNAME>",
        "ICTFAX_PASSWORD": "<YOUR_ICTFAX_PASSWORD>",
        "ICTFAX_ACCOUNT_ID": "<YOUR_ICTFAX_ACCOUNT_ID>",
        "ICTFAX_MCP_ALLOW_WRITE": "<YOUR_ICTFAX_MCP_ALLOW_WRITE>",
        "ICTFAX_TIMEOUT_MS": "<YOUR_ICTFAX_TIMEOUT_MS>",
        "ICTFAX_TLS_INSECURE": "<YOUR_ICTFAX_TLS_INSECURE>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

ictfax_list_faxes — List fax transmissions with id, contact, status, and direction
ictfax_get_fax_status — Check the status of a single transmission by id
ictfax_upload_document — Upload a local PDF as a fax document and receive a document_id (write mode only)
ictfax_send_fax — Send a local document as a fax to a phone number (write mode only)

Use cases

Monitor incoming and outgoing fax transmissions in real-time
Check the delivery status of sent faxes
Retrieve fax history and transmission details for compliance or auditing
Upload and send faxes programmatically from an AI workflow
Integrate fax operations into automated business processes

io.github.ictinnovations/ictfax-mcp MCP server FAQ

What is the ictfax-mcp server?

It's an MCP server that connects AI assistants to ICTFax, an open-source fax server. It provides tools to list, track, and optionally send faxes via the ICTCore REST API.

Is it free?

Yes, ICTFax is free and open source under the MIT license. You need your own ICTFax/ICTCore instance running.

How do I install it in Claude Desktop?

Add the server to your Claude Desktop config with the npx command and set ICTFAX_BASE_URL, ICTFAX_USERNAME, and ICTFAX_PASSWORD environment variables pointing to your ICTCore instance.

What authentication is required?

You need ICTCore REST API credentials: a base URL (ending in /api), email username, and password. The server authenticates via JWT token.

Can it send real faxes?

Yes, but only when you explicitly enable it by setting ICTFAX_MCP_ALLOW_WRITE=true. By default it is read-only to prevent accidental fax transmission costs.

What Node.js version is required?

Node.js 18 or newer is required.

README (reference)

Source of truth, from the repository.

ictfax-mcp

A Model Context Protocol server for ICTFax, the open-source fax server built on the ICTCore framework by ICT Innovations.

It lets an AI assistant list fax transmissions and check their status, and — only when you turn writes on — upload a document and send a fax.

Install

npx -y ictfax-mcp      # no install
npm install -g ictfax-mcp

Requires Node.js 18 or newer.

Configure

Variable	Required	Default
`ICTFAX_BASE_URL`	yes		ICTCore REST base, normally ending in `/api`, e.g. `https://your-ictfax/api`
`ICTFAX_USERNAME`	yes		API account email (ICTCore logs in by email)
`ICTFAX_PASSWORD`	yes		Password for that account
`ICTFAX_ACCOUNT_ID`	no	`1`	Account id to send faxes from
`ICTFAX_MCP_ALLOW_WRITE`	no	`false`	Unlock upload/send (see Safety)
`ICTFAX_TIMEOUT_MS`	no	`30000`	Per-request timeout
`ICTFAX_TLS_INSECURE`	no	`false`	Skip TLS verification — self-signed test servers only

Claude Desktop example

{
  "mcpServers": {
    "ictfax": {
      "command": "npx",
      "args": ["-y", "ictfax-mcp"],
      "env": {
        "ICTFAX_BASE_URL": "https://your-ictfax/api",
        "ICTFAX_USERNAME": "admin@example.com",
        "ICTFAX_PASSWORD": "your-password"
      }
    }
  }
}

Tools

Read tools are always available:

Tool	What it does
`ictfax_list_faxes`	List fax transmissions (id, contact, status, direction)
`ictfax_get_fax_status`	Status of one transmission by id

Write tools appear only when ICTFAX_MCP_ALLOW_WRITE=true:

Tool	What it does
`ictfax_upload_document`	Upload a local PDF as a fax document; returns a document_id
`ictfax_send_fax`	Send a local document as a fax to a number — dials a real number

Safety

The server is read-only by default. Sending a fax dials a real number and can cost money, so ictfax_upload_document and ictfax_send_fax are not registered at all unless you set ICTFAX_MCP_ALLOW_WRITE=true.

How it connects

ICTFax runs on ICTCore, which authenticates with a JWT from POST /authenticate (login by email) and reads it back from the Authorization: Bearer header. Sending a fax is a short chain the server handles for you: upload the document (metadata then raw bytes, which ICTFax converts to fax format), create the recipient and a sendfax program, create the transmission and send it.

About

Built by Tahir Almas at ICT Innovations — the team behind ICTFax, ICTPBX, ICTContact, ICTDialer and the ICTCore framework these share. ICTFax is free and open source; learn more at ictfax.org.

MIT licensed. Issues and PRs welcome at github.com/ictinnovations/ictfax-mcp.

Related MCP servers

io.github.ictinnovations/ictpbx-mcp

Active

Read ICTPBX PBX state—extensions, DIDs, SIP trunks, tenants, and live statistics via MCP.

TypeScript

MIT

View repository →

io.github.ictinnovations/pbx-mcp

Active

Inspect and control Asterisk (AMI) and FreeSWITCH (ESL) PBX servers from your AI assistant.

TypeScript

MIT

View repository →

io.github.ictinnovations/ictbroadcast-mcp

Active

Monitor and control ICTBroadcast voice, SMS, and fax campaigns from Claude or Cursor.

TypeScript

MIT

View repository →

io.github.ictinnovations/ictcontact-mcp

Active

Monitor and control ICTContact/ICTDialer outbound campaigns via AI assistant.

TypeScript

MIT

View repository →

T-Bank MCP

Active

T-Bank mobile banking API for Claude, Cursor, and other MCP agents—accounts, cards, transfers, tickets, travel, grocery.

Python

MIT

View repository →

Icyn Date

Active

Date context for agents: Chinese lunar calendar, solar terms, holidays for 12 regions. Offline.

TypeScript

MIT

View repository →