faxbeep-mcp

Faxbeep MCP server

Test a fax machine, a fax service or a scan-to-email setup from your AI agent. Faxbeep gives free public test fax numbers and test email addresses. Send a test to one, then ask your agent whether it arrived.

https://faxbeep.com/mcp

Remote server, Streamable HTTP, no authentication. Read-only.

Every test that Faxbeep receives is public on faxbeep.com for 30 days. Do not send a private document.

Add it to your chat app

• Claude: Customize > Connectors > Add custom connector. Name Faxbeep, URL https://faxbeep.com/mcp, no sign in.
• ChatGPT: turn on developer mode in the Apps settings, then create an app with the URL https://faxbeep.com/mcp and no authentication.

Menus change often. The docs have the current steps.

Add it to a coding agent

# Claude Code
claude mcp add --transport http faxbeep https://faxbeep.com/mcp

# Codex
codex mcp add faxbeep --url https://faxbeep.com/mcp

Cursor: put this in ~/.cursor/mcp.json, or in .cursor/mcp.json in a project:

{
  "mcpServers": {
    "faxbeep": {
      "url": "https://faxbeep.com/mcp"
    }
  }
}

Add it to Gemini CLI

Install the extension from this repository:

gemini extensions install https://github.com/faxbeep/faxbeep-mcp --ref main

Use /mcp to check the connection and see the three tools. The --ref main is needed: without it, the installer takes a release, and a release holds only the ChatGPT package.

Add it to Antigravity

The Antigravity plugin package connects to the hosted server. See its installation instructions.

Tools

Tool	What it does
get_test_numbers	The test fax numbers (US, UK, Australia), the test email addresses, the limits, and now, the server time
list_test_faxes	The test faxes received since a time, newest first. Filters: sender, page count, limit
get_test_fax	One test fax, by its slug (fax_1a2b3c4d) or by the URL of its page on faxbeep.com

Each result gives the sender (masked as on faxbeep.com), the time received, the page count, and links to the PDF, the thumbnail and the page of the fax.

A match by time, sender or page count narrows the candidates. It does not prove that a fax is yours, because other people send tests at the same time. Check the page.

Example

I want to test the fax machine at the office. Give me a number, and tell me when my fax arrives.

The agent calls get_test_numbers, gives you a number, and notes the server time. You send the fax. The agent calls list_test_faxes with that time and shows you the page of each new fax, so you can find yours.

To try the connection without sending anything, ask for the fax fax_example. It is a fixed sample, not a real fax.

Faxbeep does not send faxes

Faxbeep only receives. To send a test without a fax machine, use a fax sending service, for example PayPerFax, which has its own MCP server.

Documentation

• Faxbeep MCP: overview and example prompts
• MCP server reference: tools, fields, errors, polling rules, limits
• Faxbeep API: the same data over plain HTTP
• Privacy

About this repository

This repository documents the hosted server. The server code is not open source. server.json is the entry in the official MCP registry as com.faxbeep/faxbeep. Its version counts the versions of that registry entry. It is not the version that the server reports.

The files in this public repository are available under the MIT License. That license does not cover the hosted server, which is not included here.