Macfax

com.macfax由 macfax.com 发布官方发布者v1.0.3更新于 Oct 30, 2026

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

已验证Streamable HTTP可网页运行网页搜索与抓取数据与分析商业与电商

概览

AI 生成的概览

Macfax 让助手通过序列号识别 Apple 设备,并查询二手 Mac 的价格、实时商品列表与列表可信度。

可以做什么
  • 查询 Mac、iPad 或 iPhone 序列号,返回机型、设备类别与 Macfax 记录
  • 按配置获取二手 Mac 价格统计,成交价与挂牌价区间分别标注依据
  • 根据 Apple 机型名称估算 Mac 价值,覆盖该名称对应的所有配置
  • 搜索 eBay、Craigslist、OfferUp、Swappa、Facebook 和 Reddit 上的实时二手 Mac 列表,已过滤诈骗与过期条目
  • 查看单个列表的可信度,并以结构化数据读取经验证的设备状况报告
  • 为某配置创建每日邮件提醒,并查询 API 密钥的剩余额度
适用场景
适合在买卖二手 Mac 时使用:需要序列号转机型、合理价格区间、经过筛选的市场列表,或对某个具体列表做二次判断。也可用于查看卖家分享的 Macfax 报告链接。
运行要求
远程 streamable-HTTP 端点 macfax.com/mcp,无需账号即可使用;仅支持 stdio 的客户端可用 npx 本地包装器。可选 MACFAX_API_KEY 可提高速率限制;无额度时免费密钥的序列号查询次数有限。
安装前请注意
create_mac_alert 是唯一的写入工具:它会向指定邮箱发送邮件,且需邮箱所有者点击确认链接后才生效,因此只应为用户明确要求的提醒创建。序列号查询按不同序列号消耗额度。列表会深链到来源市场,实际交易在那里完成,Macfax 并非卖家。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Macfax,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.macfax%2Fmacfax/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "macfax": {
      "type": "http",
      "url": "https://macfax.com/mcp"
    }
  }
}

README

[Macfax]

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.

The hosted server (recommended)

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

来源:README.md,提交 489c611

工具

8

lookup_mac_serial

Look up an Apple serial number

Resolve a Mac, iPad or iPhone serial number to its exact model, including 2021+ randomized serials whose characters encode nothing (so no character-decoder can read them). status says what came back: resolved, unknown_serial (no such serial; check it), unsupported (a real device whose model cannot be identified yet), or retry (temporary, never charged). device_type is Apple's device class (Mac laptops, Mac desktops, iPad, iPhone). Also returns the device's record on Macfax: the month it was first seen, how often it has been looked up (first time, 2 to 5, or 6 or more), from how many countries in 30 days, and any listing, verified report or sanitization record on file. For a Mac, also returns what that model is worth (the market block: sale estimate and asking band per configuration). Lookup is advisory and cannot verify condition, Activation Lock, or possession; a Macfax report can. With credits, one credit answers one distinct serial, any Apple device and any year, and the same serial again within 24 hours is free.

输入参数serial必填context

get_mac_price_stats

Get used-Mac price statistics

What a used Mac configuration actually sells for AND what sellers are asking right now. The sold slice is the headline: verified-sale percentiles when the config has enough recent sales (sold.basis 'direct'; n and window ride along), else the asking band scaled by a measured clearance ratio (sold.basis 'calibrated', ratio disclosed). The asking band (median/p25/p75 with sample size), per-channel medians with net-to-seller after fees, launch MSRP retention and Apple trade-in floor ride along as seller guidance. Use the sold estimate as the price of the Mac; use asking to set a list price. The slices are separate and never blended — preserve the basis label when quoting.

输入参数config必填

get_mac_market_value

Get what a Mac model is worth

What a used Mac is worth, from the name Apple gives the model, e.g. "MacBook Pro (14-inch, 2021)" or "MacBook Air (13-inch, M4, 2025)". Returns every Apple Silicon configuration the name can mean, each with its sale estimate (verified sales, or the asking band scaled by a measured clearance ratio; basis labeled) and its live asking band, plus an estimate across them: a single mid when the name pins one configuration, a low-to-high range when Apple's name leaves the chip open. Apple Silicon Macs only. Use the sale estimate as the price of the Mac; asking is seller guidance.

输入参数model必填

search_mac_listings

Search live used-Mac listings

Live used-Mac listings aggregated across eBay, Craigslist, OfferUp, Swappa, Facebook and Reddit, with scam clusters, junk titles, classified-ad bait, auctions and stale/sold rows already filtered out. Every result deep-links to the source listing where the purchase happens. Filter by configuration, family, chip, RAM, storage, price ceiling, and verified-report tier.

输入参数sortyearlimitconfigfamilyram_gbmin_tierchip_tierstorage_gbmax_price_usd

check_mac_listing

Check a used-Mac listing before trusting it

The trust picture for one specific listing, by URL (eBay/Craigslist/OfferUp/Swappa/Facebook/Reddit) or Macfax listing id: whether Macfax knows it, whether it still passes every quality gate, scam/junk/classified/auction flags, when a scan last verified it live, its ask against the configuration's typical asking band, the platform's own seller-reputation figures where the marketplace has them (seller_signals: eBay feedback, Swappa rating; null elsewhere), and whether a verified Macfax report is attached. Facts, not verdicts.

输入参数idurl

get_mac_report

Fetch a verified Macfax report

A verified Macfax condition report as structured data: hardware-verified identity, Activation Lock / MDM / serial-match checks, coverage status, and the signing chain. Use when a listing or seller shares a macfax.com/r/ link and the buyer wants the facts behind it. status "superseded" means the same Mac was re-verified more recently under a newer report; treat the payload as historical state, not current.

输入参数report_id必填

create_mac_alert

Create a standing used-Mac listing alert

Watch the market for a configuration: Macfax emails the given address when new matching listings appear. CONSENT CONTRACT: create an alert only for a user who explicitly asked for this alert on this email address. The first alert for a new email stays inactive until the email's owner clicks the confirmation link Macfax sends; nothing is emailed before that, and every alert email carries manage and unsubscribe links.

输入参数email必填config必填ram_gbmin_tierstorage_gbmax_price_usdunder_typical

get_macfax_credit_balance

Check Macfax credits

How many credits this API key has left, and what costs one. One credit answers one distinct serial, any Apple device and any year, and the same serial again within 24 hours is free. Answers that come back retry or unsupported, and every other tool, are free. Without credits, a free key gets 25 brand new 2021+ resolutions and 200 distinct serials a day. Call this before a large batch of serials to find out whether it can be finished. Without a key it reports the anonymous allowance instead.

无需输入参数。

版本历史

3
  1. v1.0.3最新Oct 9, 2026
  2. v1.0.2Oct 7, 2026
  3. v1.0.1Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分