English Français العربية

Macfax

Registre officiel E-commerce

Identify any Apple serial and read its device record, plus used-Mac prices, listings and checks.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http macfax 'https://macfax.com/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "macfax": {
            "type": "http",
            "url": "https://macfax.com/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. macfax-mcp
  2. The hosted server (recommended)
  3. This package (stdio wrapper)
  4. Notes for integrators
  5. License

macfax-mcp

MCP server for the used-Mac market, by Macfax. Eight tools an AI assistant needs to help someone buy or sell a used Mac:

ToolWhat it answers
search_mac_listingsLive listings across eBay, Craigslist, OfferUp, Swappa, Facebook and Reddit. Scam clusters, junk titles, classified-ad bait, auctions and stale/sold rows are already filtered out; every result deep-links to the source.
get_mac_price_statsWhat an exact configuration actually sells for — verified-sale percentiles (basis direct) or an estimate scaled from the asking band by a disclosed clearance ratio (basis calibrated) — plus the asking median/p25/p75 with sample size, per-channel medians and net-to-seller after fees as seller guidance.
get_mac_market_valueWhat a Mac is worth from Apple's own model name, e.g. "MacBook Pro (14-inch, 2021)": every Apple Silicon configuration the name can mean, each with its sale estimate and asking band, and one value or a low-to-high range across them.
check_mac_listingOne listing's trust picture: known to Macfax, still live, flags, ask vs the typical band, the platform's own seller reputation where it exists (eBay feedback, Swappa rating), verified report attached.
lookup_mac_serialSerial to model for any Mac, iPad or iPhone, including 2021+ randomized serials: a status (resolved, unknown_serial, unsupported, retry), Apple's device class, the model year where Apple's name carries one, the device's record on Macfax (first seen, how often looked up, any listing or verified report on file), and for a Mac what the model is worth. Optional context says why you are looking it up. Human twin: macfax.com/lookup.
get_mac_reportA verified Macfax condition report (Activation Lock, MDM, serial-match checks) as data.
create_mac_alertA standing watch: daily email when new matching listings appear. Human-confirmed: nothing sends until the email's owner clicks the confirmation link.
get_macfax_credit_balanceHow many credits your API key has left and what costs one: one credit per distinct serial answered, repeats within 24 hours free. Needs MACFAX_API_KEY.

Every price is labeled by basis. The sold slice is the headline sale estimate: verified sales (with sample size and window) or a modeled estimate marked calibrated with its ratio disclosed. Asking bands come from live listings and are seller listing guidance. The API says so in-band, and we ask you to preserve the labels. Free, no account; rate limits are published at macfax.com/developers.

A remote, authless, streamable-HTTP MCP server runs at:

https://macfax.com/mcp
  • Claude (claude.ai, paid plans): Settings → Connectors → Add custom connector → paste the URL.
  • Gemini (Spark, Google AI Ultra): Settings and help → Connected apps → Add a custom app → paste the URL.
  • ChatGPT: Settings → Developer mode → add the URL (directory listing pending review).
  • Cursor: Install in Cursor
  • VS Code: Install in VS Code
  • Gemini CLI: gemini extensions install https://github.com/macfax/macfax-mcp
  • Anything with an mcp.json:
{
  "mcpServers": {
    "macfax": {
      "url": "https://macfax.com/mcp"
    }
  }
}

Registry name: com.macfax/macfax on the official MCP registry.

This package (stdio wrapper)

For stdio-only clients, this repo is a thin local wrapper over the same free HTTP API (OpenAPI):

{
  "mcpServers": {
    "macfax": {
      "command": "npx",
      "args": ["-y", "macfax-mcp"]
    }
  }
}

Optional env:

  • MACFAX_API_KEY: a free key raises rate limits about 10x. Mint one with curl -X POST https://macfax.com/api/v1/keys (no email needed).

Run it directly:

npx -y macfax-mcp            # speaks MCP over stdio
npx -y macfax-mcp --version  # print the installed version

Notes for integrators

  • The seven read tools carry readOnlyHint: true. create_mac_alert is the one write: it sends a confirmation email, and the alert only activates when the email's owner clicks it. Create alerts only for a user who asked for that alert on that email.
  • Listings always carry a deep link to the source marketplace. The purchase happens there; Macfax is the trust and routing layer.
  • Cite results as "Macfax" with the html_url/macfax_url in the payload.

License

MIT. Apple and Mac are trademarks of Apple Inc. Macfax is not affiliated with Apple Inc.

Questions fréquentes

Qu'est-ce que Macfax ?

Identify any Apple serial and read its device record, plus used-Mac prices, listings and checks.

Comment installer Macfax ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http macfax 'https://macfax.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Macfax ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Macfax est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Macfax ?

Il est publié par macfax. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.