apipriceindex

apipriceindex-mcp

一个 MCP 服务，为任何 AI Agent 提供实时、经验证的大模型 API 价格，以及今日优惠。

询问助手 “现在有哪些大模型可以免费调用？”、“至少和 GPT-5.6 Sol 一样好的模型中，哪个最便宜？” 或 “我每月使用 2 亿输入 / 1,500 万输出令牌，在 Sonnet 和 GPT 上分别要花多少钱？”，它都会根据今日索引作答——每个价格都附有验证日期、交叉核对置信度和来源 URL。数据来自 apipriceindex.com（CC BY 4.0，每天从各服务提供商自己的价格清单或 OpenRouter 的服务提供商数据中重新核验；每个价格都在 source_url 中注明来源）。

工具

工具	功能
search_models	按名称 / 服务提供商查找模型 ID；可按上下文窗口、开放权重、最高价格（输入 + 输出）、能力（工具、推理、视觉、json）和最低速度筛选
get_price	单个模型经验证的价格：每百万令牌的输入 / 输出 / 缓存输入美元价格、verified_at、confidence、来源；已知时还会提供速度、可用性和 Epoch 评分；对于开放权重模型，还会提供托管方提供的权重精度、上下文和最大输出量，以及各项的状态、来源和日期
estimate_cost	工作负载的月度费用；按价格从低到高排列指定模型或整个目录
list_deals	当前可免费调用的模型、折扣、免费额度和免费层级——每项都附有结束日期和官方来源；可筛选“在 N 天内结束”
offers_table	提供同一模型的所有托管方，以及你选择的列（输入、输出、缓存、折扣、速度、首个令牌、运行时间、精度、上下文、最大输出量、verified_at）
compare_models	并排比较 2 至 4 个模型：最低价格及提供方、服务提供商、最快的托管方、上下文、许可证、Epoch 评分、月度费用
cheapest_at_level	达到某个 Epoch Capabilities Index 评分的最便宜模型，或与你指定的模型一样好的模型
price_changes	过去 N 天的价格涨跌，以及这段时间发布的模型

安装

pip install apipriceindex-mcp

Claude Code / Claude Desktop：

claude mcp add apipriceindex -- apipriceindex-mcp

或在任何 MCP 客户端配置中：

{ "mcpServers": { "apipriceindex": { "command": "apipriceindex-mcp" } } }

行为

• 实时从索引获取数据（内存缓存 15 分钟）—— 不使用过时的训练数据。
• 索引无法访问 → 明确报错。 绝不会在不作提示的情况下提供缓存或捏造的价格。
• 索引超过 14 天未更新 → 仍会返回答案，并附上指向索引健康检查端点的警告。
• 未跟踪的模型 → 会明确说明，并链接到数据集。不会捏造价格。
• 仅在服务提供商公布缓存输入价格时提供缓存折扣。
• 优惠始终附有结束日期——如果托管方未公布结束日期，则显示 no end date——并附上指向托管方自有页面的链接。
• 速度和可用性数据来自 OpenRouter，并始终附有统计窗口（30 分钟内的中位数、24 小时内成功请求的占比）。不提供尾延迟或错误率。
• 托管方提供的内容（权重精度、上下文、最大输出量）取自托管方自己的目录或文档（前提是其条款允许），否则采用托管方向 OpenRouter 声明的内容。每项值都附有状态：published（已公布）、not_stated（托管方来源未说明）、not_read（托管方条款禁止自动读取，且 OpenRouter 没有该值）或 to_check（待核实）。不会进行猜测。
• 唯一采用的第三方评分是 Epoch AI 的 Epoch Capabilities Index（CC BY 4.0）。所有包含该评分的答案都会标注出处。除此之外只比较成本：索引不对模型质量进行排名。

环境变量：APIPRICEINDEX_URL 可覆盖数据集 URL（用于测试）；deals.json 和 pricing-history.csv 会从同一位置读取。

更新日志

• 0.3.0 — 对于每个提供开源权重模型的托管方，get_price 会返回 served.precision、served.context 和 served.max_output， 每项均附带状态、来源和日期；并在 served.maker 中提供模型厂商的数值；offers_table 新增 precision 和 max_output 列，空白的已提供值单元格会附带 <column>_state。其他回答 不变。
• 0.2.1 — get_price 和本 README 现在说明价格的读取来源： 每个提供商自己的价格列表，或 OpenRouter 的提供商级数据，并通过 source_url 标明。此前称为“官方定价页面”，但实际只有约四分之一的价格来自官方定价页面。工具及其回答均未更改。
• 0.2.0 — 新增 list_deals、offers_table、compare_models、 cheapest_at_level、price_changes；search_models 新增最高价格、 能力和最低速度筛选；在已知的情况下提供 Epoch 评分、速度和可用性。 0.1 版的三个工具仍按原样回答。
• 0.1.1 — search_models、get_price、estimate_cost

许可证

代码：MIT。价格数据：CC BY 4.0， 署名为“API Price Index”。Epoch Capabilities Index：CC BY 4.0，注明来源为 Epoch AI。