macfax-mcp

macfax-mcp is an MCP server for the used-Mac market, created by Macfax. It provides deep links to quality-gated listings, includes asking-price statistics, and performs trust checks with alerts. The server exposes six tools for AI assistants to help users buy or sell used Macs.

🛠️ Key Features

Used-Mac market listings with deep links
Quality-gated listings and trust checks
Asking-price statistics and alerts
Tooling count: 6 tools
Topics include mcp, model-context-protocol, mac, macbook, and price-tracker

🚀 Use Cases

Finding live used-Mac listings
Verifying listing quality and trust
Tracking market asking prices for purchase decisions

⚡ Developer Benefits

Centralized listing search across marketplaces: eBay, Craigslist, OfferUp, Swappa, Facebook, and Reddit
Automated filtering of scam clusters, junk titles, classified-ad bait, auctions, and stale/sold rows

⚠️ Limitations

The provided documentation excerpt only fully specifies search_mac_listings; other tools are not described in the source excerpt.

macfax-mcp

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

Tool	What it answers
`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.
`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.
`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.
`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.
`get_mac_report`	A verified Macfax condition report (Activation Lock, MDM, serial-match checks) as data.
`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.

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.

The hosted server (recommended)

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

code

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:

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):

json

{
  "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:

bash

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

Notes for integrators

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.
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.

config	string	optional	Macfax config key: family[-screen]-chip-year, optionally -RAMgb-STORAGEgb. Examples: macbook-pro-14-m3pro-2023, mac-studio-m2ultra-2023-192gb-1024gb. The year may be omitted when the rest pins one build: mac-studio-m3ultra resolves to mac-studio-m3ultra-2025.
family	string	optional	Coarse browse by product family.
chip_tier	string	optional	e.g. m3, m3pro, m4max, m3ultra
year	integer	optional
ram_gb	integer	optional
storage_gb	integer	optional
max_price_usd	integer	optional
min_tier	string	optional	free/premium = only listings with a verified Macfax report attached.
sort	string	optional
limit	integer	optional

url	string	optional	The listing's URL on the source marketplace.
id	string	optional	A Macfax listing id (from search results).

email	string	required	The user's own email address. Confirmation is required before anything sends.
config	string	required	Macfax config key: family[-screen]-chip-year, optionally -RAMgb-STORAGEgb. Examples: macbook-pro-14-m3pro-2023, mac-studio-m2ultra-2023-192gb-1024gb.
ram_gb	integer	optional
storage_gb	integer	optional
max_price_usd	integer	optional	Only alert under this asking price.
min_tier	string	optional
under_typical	boolean	optional	Only listings under the configuration's typical asking range.

Macfax

macfax-mcp

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

lookup_mac_serial

get_mac_price_stats

search_mac_listings

check_mac_listing

get_mac_report

create_mac_alert

macfax-mcp

The hosted server (recommended)

This package (stdio wrapper)

Notes for integrators

License

Install

Remote endpoint

Related servers