Skillget

ictfax-mcp

mcp
Security Audit
Warn
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 17 GitHub stars
Code Warn
  • network request — Outbound network request in src/client.ts
  • process.env — Environment variable access in src/config.ts
  • process.env — Environment variable access in src/index.ts
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

MCP server for ICTFax — list and track faxes, upload documents and send faxes over ICTCore REST. By ICT Innovations.

README.md

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": "[email protected]",
        "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.

Reviews (0)

No results found