{
  "markdown": "<p align=\"center\">\n  <a href=\"https://macfax.com/developers\">\n    <img src=\"https://raw.githubusercontent.com/macfax/macfax-mcp/main/assets/lockup.svg\" alt=\"Macfax\" width=\"400\">\n  </a>\n</p>\n\n# macfax-mcp\n\nMCP server for the used-Mac market, by [Macfax](https://macfax.com). Six tools an AI assistant needs to help someone buy or sell a used Mac:\n\n| Tool | What it answers |\n|---|---|\n| `search_mac_listings` | Live 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. |\n| `get_mac_price_stats` | What 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. |\n| `check_mac_listing` | One 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. |\n| `lookup_mac_serial` | Serial to model and year for any Mac, including 2021+ randomized serials. Also cross-references verified Macfax reports. Human twin: [macfax.com/lookup](https://macfax.com/lookup). |\n| `get_mac_report` | A verified Macfax condition report (Activation Lock, MDM, serial-match checks) as data. |\n| `create_mac_alert` | A standing watch: daily email when new matching listings appear. Human-confirmed: nothing sends until the email's owner clicks the confirmation link. |\n\nEvery 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](https://macfax.com/developers).\n\n## The hosted server (recommended)\n\nA remote, authless, streamable-HTTP MCP server runs at:\n\n```\nhttps://macfax.com/mcp\n```\n\n- **Claude** (claude.ai, paid plans): Settings → Connectors → *Add custom connector* → paste the URL.\n- **Gemini** (Spark, Google AI Ultra): Settings and help → Connected apps → *Add a custom app* → paste the URL.\n- **ChatGPT**: Settings → *Developer mode* → add the URL (directory listing pending review).\n- **Cursor**: [Install in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=macfax&config=eyJ1cmwiOiJodHRwczovL21hY2ZheC5jb20vbWNwIn0=)\n- **VS Code**: [Install in VS Code](vscode:mcp/install?%7B%22name%22%3A%20%22macfax%22%2C%20%22serverUrl%22%3A%20%22https%3A//macfax.com/mcp%22%7D)\n- **Gemini CLI**: `gemini extensions install https://github.com/macfax/macfax-mcp`\n- **Anything with an `mcp.json`**:\n\n```json\n{\n  \"mcpServers\": {\n    \"macfax\": {\n      \"url\": \"https://macfax.com/mcp\"\n    }\n  }\n}\n```\n\nRegistry name: [`com.macfax/macfax`](https://registry.modelcontextprotocol.io/v0.1/servers?search=com.macfax/macfax) on the official MCP registry.\n\n## This package (stdio wrapper)\n\nFor stdio-only clients, this repo is a thin local wrapper over the same free HTTP API ([OpenAPI](https://macfax.com/api/v1/openapi.json)):\n\n```json\n{\n  \"mcpServers\": {\n    \"macfax\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"macfax-mcp\"]\n    }\n  }\n}\n```\n\nOptional env:\n\n- `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).\n\nRun it directly:\n\n```bash\nnpx -y macfax-mcp            # speaks MCP over stdio\nnpx -y macfax-mcp --version  # print the installed version\n```\n\n## Notes for integrators\n\n- The five 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.\n- Listings always carry a deep link to the source marketplace. The purchase happens there; Macfax is the trust and routing layer.\n- Cite results as \"Macfax\" with the `html_url`/`macfax_url` in the payload.\n\n## License\n\nMIT. Apple and Mac are trademarks of Apple Inc. Macfax is not affiliated with Apple Inc.\n",
  "bytes": 4390,
  "sha": "b9924510a30205599f5c8c4b20fcd6bf6a627965e47efb1e02c8cc1de0760d9d",
  "repo_slug": "macfax/macfax-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_macfax_macfax_90d6d663/readme"
}