\n\n# GotFreeFax MCP Server\n\n[](https://opensource.org/licenses/MIT)\n[](https://modelcontextprotocol.io/)\n\n> Send faxes to the US and Canada from Claude, ChatGPT, Codex, and other AI agents over the [Model Context Protocol](https://modelcontextprotocol.io/). **No account required to start.**\n\n- **Endpoint:** `https://www.gotfreefax.com/mcp`\n- **Full docs:** \n- **Service homepage:** \n\n---\n\n## What it does\n\nThe GotFreeFax MCP Server exposes [GotFreeFax.com](https://www.gotfreefax.com)'s fax-sending capabilities as MCP tools. An AI agent can:\n\n- **Send a free fax** to any US/Canada number (3-page limit, 2/day per email & IP, email-confirmation required)\n- **Send a paid fax** (up to 300 pages, no confirmation step) once the user has a prepaid account\n- **Purchase prepaid credits** without leaving the chat — the tool returns a PayPal payment link\n- **Check fax status, list sent faxes, and view account balance**\n\nThe free tier means a brand-new user can complete a real workflow (\"Claude, please fax this to my doctor\") with no signup. Paid tiers unlock larger documents and remove the confirmation step.\n\n## Quick start (Claude Desktop, free, no account)\n\nAdd this to your `claude_desktop_config.json` and restart Claude Desktop:\n\n```json\n{\n \"mcpServers\": {\n \"gotfreefax\": {\n \"command\": \"npx\",\n \"args\": [\"mcp-remote\", \"https://www.gotfreefax.com/mcp\"]\n }\n }\n}\n```\n\nThen ask Claude something like:\n\n> *\"Send a free fax to 555-123-4567 with the text 'Hello from Claude'.\"*\n\nClaude calls `send_free_fax`, you receive a confirmation link by email, and the fax sends once you click it.\n\nRequires Node.js installed locally — `mcp-remote` bridges Claude Desktop to the remote MCP endpoint.\n\n## Available tools\n\n| Tool | Description | Auth |\n|---|---|---|\n| `send_free_fax` | Send a free fax (≤3 pages, 2/day/email/IP, email-confirmation required) | None |\n| `send_fax` | Send a fax via a prepaid account (≤300 pages, no confirmation) | Bearer |\n| `check_fax_status` | Look up the delivery status of a fax by `job_id` | None |\n| `list_sent_faxes` | List paid faxes the authenticated account has sent | Bearer |\n| `get_account_balance` | Current page balance + dollar balance for the authenticated account | Bearer |\n| `purchase_credits` | Start a prepaid credit purchase. Returns a PayPal payment URL. Authenticated → credits added to existing account; unauthenticated → creates account from email+name | Optional Bearer |\n| `list_supported_formats` | Static list of accepted file types (PDF, DOC, DOCX, JPG, JPEG, TXT) | None |\n\nSee the [full documentation](https://www.gotfreefax.com/mcp-server) for per-tool parameter schemas and response shapes.\n\n## Client setup\n\n### Claude Desktop\n\n**No credentials (free tools only):** see [Quick start](#quick-start-claude-desktop-free-no-account) above, or [examples/claude_desktop_config.json](examples/claude_desktop_config.json).\n\n**With credentials (full access):** see [examples/claude_desktop_config.with-auth.json](examples/claude_desktop_config.with-auth.json).\n\n### Codex CLI (OpenAI)\n\nAdd to `~/.codex/config.toml` — see [examples/codex.config.toml](examples/codex.config.toml).\n\n### ChatGPT\n\nChatGPT's MCP support is rolling out across surfaces. The most reliable path as of mid-2026 is the ChatGPT desktop app's connector / MCP settings; the web UI uses an OAuth-based Connectors mechanism configured in account settings (not via JSON files). The values you need:\n\n- **Endpoint:** `https://www.gotfreefax.com/mcp`\n- **Transport:** Streamable HTTP (JSON-RPC 2.0 over POST)\n- **Authentication (for paid tools):** Bearer token, format `\"Bearer \" + base64(account_number + \":\" + pin)`\n\nFollow OpenAI's current documentation for the exact UI steps.\n\n### Cursor, Windsurf, and other MCP clients\n\nAny client that speaks MCP over HTTP can connect. Use the same JSON shape as Claude Desktop in the client's MCP settings.\n\n### Raw JSON-RPC (custom clients)\n\n```bash\ncurl -X POST https://www.gotfreefax.com/mcp \\\n -H \"Content-Type: application/json\" \\\n -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'\n```\n\nSee the [Examples section](https://www.gotfreefax.com/mcp-server#examples) of the canonical docs for full per-tool requests and responses.\n\n## Authentication\n\nFree tools work anonymously. Authenticated tools require an `Authorization` header:\n\n```\nAuthorization: Bearer \n```\n\nWhere `account_number` and `pin` come from a GotFreeFax prepaid account. You can buy one through the `purchase_credits` tool without leaving your AI client — after PayPal payment, account credentials are emailed to you.\n\nRate limiting: 5 failed auth attempts per IP per 30 min; 10 per account per 30 min. Detailed PIN/auth design at the [Authentication section](https://www.gotfreefax.com/mcp-server#authentication) of the docs.\n\n## Pricing\n\n| Tier | Cost | Includes |\n|---|---|---|\n| Free (`send_free_fax`) | $0 | 3 pages max, 2/day per email/IP, email-confirmation step |\n| Prepaid 100 pages | $9.95 | `send_fax` with no confirmation step |\n| Prepaid 250 pages | $19.95 | as above |\n| Prepaid 800 pages | $49.95 | as above |\n| International prepaid | $49.95 / $99.95 / $199.95 | dollar-balance-based, see docs |\n\n`purchase_credits` returns a standard PayPal payment URL; payment is processed by PayPal. GotFreeFax does not store payment instruments.\n\n## Privacy & terms\n\nThis MCP server is a thin protocol surface over the existing [GotFreeFax.com](https://www.gotfreefax.com) service. Standard service terms apply:\n\n- **Terms of Service:** \n- **Privacy Policy:** \n\nFax content, sender/recipient identifiers, and account credentials are transmitted to GotFreeFax for delivery. No fax content is logged beyond what's required for delivery and statutory record-keeping.\n\n## About this repo\n\nThis repository is the canonical project page for the GotFreeFax MCP Server, containing setup examples, an MCP manifest, and pointers to the live service. The server itself is hosted at `https://www.gotfreefax.com/mcp` — there is no local installation. The repo is published under the MIT License so the config snippets are free to copy into your own setups.\n\nThe server implementation is part of the GotFreeFax.com web application (closed-source).\n\n## Links\n\n- **MCP endpoint:** \n- **Full developer documentation:** \n- **REST API documentation:** \n- **GotFreeFax homepage:** \n- **Model Context Protocol:** \n- **`mcp-remote` (the npm bridge):** \n",
"bytes": 7027,
"sha": "896127e1d3c7506c1f27eb1ddc2b352e69d4a9c81a5e91836c7ea304c714526c",
"repo_slug": "vannet/gotfreefax-mcp",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_com_gotfreefax_mcp_ce29e802/readme"
}
![\"GotFreeFax\"](\"wordmark.png\")
\n \n