Ictfax Mcp

io.github.ictinnovationsPublished by GitHub account ictinnovationsv0.1.1Updated Oct 26, 2026

List and track faxes on ICTFax, and send faxes when writes are enabled, over ICTCore REST.

VerifiedSTDIODesktop onlyProductivity & WorkflowCommunication & Collaboration

Overview

AI-generated overview

Connects an assistant to an ICTFax server over ICTCore REST to list and track fax transmissions, and optionally upload and send faxes.

What you can do
  • List fax transmissions with id, contact, status and direction
  • Look up a single transmission's status, contact and page count
  • When writes are enabled: upload a local PDF as a fax document and send it to a number
When to use it
Useful when you run an ICTFax server and want an assistant to check inbound and outbound fax status, or to prepare and send a fax from a local PDF after explicitly enabling writes.
Requirements
Runs locally via npx or a global npm install; needs Node.js 18 or newer. Requires ICTFAX_BASE_URL (ICTCore REST base, usually ending in /api), ICTFAX_USERNAME (account email) and ICTFAX_PASSWORD. Optional: ICTFAX_ACCOUNT_ID, ICTFAX_MCP_ALLOW_WRITE, ICTFAX_TIMEOUT_MS, ICTFAX_TLS_INSECURE. Network access to the fax server.
Before you install
ICTFAX_PASSWORD is a required secret stored in the environment. Setting ICTFAX_MCP_ALLOW_WRITE=true registers upload and send tools that dial a real number and can cost money; leave it off unless intended. ICTFAX_TLS_INSECURE disables certificate verification and should only be used with self-signed test servers. Fax content and account credentials go to the configured ICTFax server.

Installation

In SourceWeft

  1. Open Ictfax Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
npx -y ictfax-mcp      # no installnpm install -g ictfax-mcp

Requires Node.js 18 or newer.

Configure

VariableRequiredDefault
ICTFAX_BASE_URLyesICTCore REST base, normally ending in /api, e.g. https://your-ictfax/api
ICTFAX_USERNAMEyesAPI account email (ICTCore logs in by email)
ICTFAX_PASSWORDyesPassword for that account
ICTFAX_ACCOUNT_IDno1Account id to send faxes from
ICTFAX_MCP_ALLOW_WRITEnofalseUnlock upload/send (see Safety)
ICTFAX_TIMEOUT_MSno30000Per-request timeout
ICTFAX_TLS_INSECUREnofalseSkip TLS verification — self-signed test servers only

Claude Desktop example

json
{  "mcpServers": {    "ictfax": {      "command": "npx",      "args": ["-y", "ictfax-mcp"],      "env": {        "ICTFAX_BASE_URL": "https://your-ictfax/api",        "ICTFAX_USERNAME": "[email protected]",        "ICTFAX_PASSWORD": "your-password"      }    }  }}

Tools

Read tools are always available:

ToolWhat it does
ictfax_list_faxesList fax transmissions (id, contact, status, direction)
ictfax_get_fax_statusStatus of one transmission by id

Write tools appear only when ICTFAX_MCP_ALLOW_WRITE=true:

ToolWhat it does
ictfax_upload_documentUpload a local PDF as a fax document; returns a document_id
ictfax_send_faxSend 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.

Source: README.md at commit e0ab40e

Tools

2

ictfax_list_faxes

List fax transmissions

List fax transmissions on the server (inbound and outbound) with their id, contact, status and direction. Start here to find a transmission id.

Takes no parameters.

ictfax_get_fax_status

Get fax status

Get one fax transmission by id: its status (processing, completed, failed), contact and pages. Poll this after sending a fax.

Parameterstransmission_idrequired

Version history

2
  1. v0.1.1LatestOct 26, 2026
  2. v0.1.0Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts