Prereason

询问 AI 美国国债收益率是多少。单靠它自己，它会搜索结果或原始数据序列，然后自行推导其余信息。使用 Prereason 后，只需调用一次 get_context，即可获取已整理好的背景信息：2026-10-07，30 年期收益率为 5.67%，是美国财政部每日平价收益率曲线自 2001 年 7 月以来的最高读数。

为什么要提前推理？

• 提供分析及其背后的数据。 每份简报都附有分析结果：多个时间窗口内的趋势、数值在自身历史数据中的位置、公司在同业中的排名，以及（如果有）公司的指导意见。
• 每个数字都标注日期，每个来源都明确列出。 Agent 可以说明数字的时间和来源。
• 一次调用，获取完整简报。 简报会汇总问题所需的数据序列，让对话把重点放在回答上，而不是查找数据。
• 市场信息一站掌握。 利率和美国国债、美联储、外汇、大宗商品、宏观经济、在美国、日本、韩国和印度上市的公司，以及 Bitcoin。
• 只描述，不提供建议。 简报说明数据反映的情况，但绝不建议买入、卖出或持有。
• 快速配置。 只需为 Claude、Cursor、Codex 或 VS Code 添加一段配置，即可通过 npm 桥接或远程服务接入。目录工具无需密钥；对于其他工具，桥接服务会提供一个链接，让你在浏览器中授权，密钥随后便会传入正在运行的会话；远程服务则通过请求头接收你的 API 密钥。

覆盖内容

PreReason 为 AI Agent 提供可供其推理的市场背景。一次调用即可返回一份包含分析的简报：一句话解读、多个时间窗口内的趋势方向、置信度评分、百分位排名和相关性；更深入的简报还会提供市场状态标签和通俗易懂的叙述。简报涵盖宏观经济、债券、外汇、大宗商品、Bitcoin、Ethereum 和跨资产相关性。公司简报涵盖美国、日本、韩国、印度、英国、法国、奥地利、比利时、丹麦、芬兰、冰岛、意大利、立陶宛、荷兰、斯洛文尼亚和斯洛伐克的上市公司，每次调用一家公司。目录包含 33 份实时简报和 293 项独立指标，其中包括美国国债收益率、最新的 FOMC 声明、宏观经济数据发布日历、美国国债拍卖、美国国债持有者、Fed 资产负债表、M2、净流动性、美元、美国原油和天然气库存、黄金、白银、铜和小麦、石油、采矿和农业综合企业及其大宗商品、AI 算力和电力需求、Bitcoin 价格与动能、Bitcoin 网络和矿工健康状况、现货 Bitcoin ETF 资金流以及企业 Bitcoin 储备。服务通过 MCP（远程服务和 npm 桥接程序）以及 REST 提供，支持 Markdown 或 JSON 格式。通过 MCP，目录工具无需账户即可使用；获取简报则需要 PreReason 账户，通过连接器登录或使用 API 密钥；免费账户可读取免费简报。通过 REST 获取简报时，可使用 API 密钥，或者在支持 x402 的路由上按次付款，无需账户。

快速开始

选项 1：Claude Desktop，无需密钥

需要 Node.js 18+，无需其他依赖：桥接程序没有任何依赖项。

将以下内容添加到 claude_desktop_config.json，然后重启 Claude Desktop：

{
  "mcpServers": {
    "prereason": {
      "command": "npx",
      "args": ["-y", "@prereason/mcp"],
      "env": { "PREREASON_CLIENT": "claude-desktop" }
    }
  }
}

目录工具可立即使用。要连接账户，请告诉 Claude“connect me to PreReason”，或请求任意简报：无论哪种方式，Claude 都会显示一个链接：https://www.prereason.com/claim/PR-XXXX-XXXX。打开链接后登录或创建免费账户，再点击 Approve。密钥会自动发送到桥接程序，保存到 ~/.prereason/credentials.json，且绝不会显示出来；询问 Claude 是否已连接 PreReason，它会告知你的套餐。点击 Approve 前，系统不会在你的账户中创建任何内容；只有需要时才会请求链接，因此即使 Claude 一直开着，链接也不会过期。如果你的账户持有的 API 密钥已达到上限，系统会直接说明，而不会反复尝试：请在 prereason.com 的 Settings 中撤销一个密钥，然后再次请求连接；或者将 PREREASON_API_KEY 设置为你已有的密钥。

配置文件位置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

已有密钥？将其添加到 env 块中，格式为 "PREREASON_API_KEY": "pr_live_..."，桥接程序便不会再询问。

选项 2：使用 API 密钥直接通过 HTTP 连接（Claude Code、Cursor、Windsurf、Codex、Gemini CLI、VS Code、脚本）

可以自行管理配置的客户端可直接调用端点，并将密钥作为标头传递：

# Claude Code
claude mcp add --transport http prereason https://api.prereason.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

{
  "mcpServers": {
    "prereason": {
      "type": "http",
      "url": "https://api.prereason.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Windsurf 使用 serverUrl，而不是 url；Gemini CLI 使用 httpUrl；Codex 在 config.toml 中使用 url 和 bearer_token_env_var。尚无密钥？先让客户端在不带标头的情况下连接端点以浏览目录，然后在网站上创建密钥（见下文），并添加标头。

选项 3：Claude.ai 和 Claude Desktop 自定义连接器

将 PreReason 添加为自定义连接器，选择“No sign-in”，并在 Request headers 部分可用时，添加值为 Bearer YOUR_API_KEY 的 Authorization（Bearer 一词和后面的空格都属于该值）。连接器的登录支持正在重新测试，验证完成前不会提供。

获取 API 密钥

有三种方式，全部免费。托管服务绝不会在会话中发放密钥，也不会索要密钥。

通过此桥接程序。 不设置密钥即可运行：当你要求助手连接 PreReason，或回答需要密钥时，它会代表你向 PreReason 请求访问权限，并在日志和回答中显示一个 approve_url。打开该链接，登录或创建账户，点击 Approve，桥接程序便会保存密钥；该密钥与你的账户关联，名称为 Agent: <client_name>。

通过代码，为没有浏览器的 Agent 获取密钥。 发送 POST https://api.prereason.com/api/agent/claims（无需身份验证），向用户显示 approve_url，然后使用 Authorization: Bearer <claim_token> 轮询 GET https://api.prereason.com/api/agent/claims/{claim_code}，直到 status 为 approved。文档：prereason.com/docs#agent-access。

通过网站。 在 prereason.com/signup 注册，然后依次前往 Dashboard > Settings > API Keys。密钥以 pr_live_ 开头。

7 个 MCP 工具

工具	身份验证	描述
list_briefings	开放	列出全部 33 篇预先分析的市场简报及其层级要求；使用 search 时，仅列出与问题匹配的简报及其中提及的相关公司，并为每家公司提供要传入的 entity
list_metrics	开放	列出 bitcoin、macro、calculated 和 eth 分类下的所有可用指标
get_health	开放	API 健康检查、版本、账户层级
get_context	必需	获取预先分析的市场简报（markdown 或 JSON）；对于公司简报，entity 用于指定公司，block 用于读取其 11 个部分中的一个（参见 Company Briefings）
get_metric	必需	获取单个指标及其趋势／信号／百分位数
get_changes	必需（Basic 及以上）	自上次调用以来的变化：游标之后的变化事件，不包含数值
get_news	必需	按时间倒序排列的记录，列出公司提交的文件、联邦机构和美联储发布的内容；每条记录都包含来源、日期或时间以及链接；仅说明记录内容，不说明原因

npm 桥接程序和 Claude Desktop 扩展各自添加了一个工具 connect_account。该工具由桥接程序自行响应，远程服务不提供：尚未设置密钥时，它会返回唯一的授权链接；授权完成后，它会告知账户已连接以及所用套餐。它绝不显示密钥，也不会索要密钥。

33 篇市场简报

免费（6 篇简报）

简报	描述
btc.quick-check	精简快速背景：BTC + 净流动性 + 相关性
btc.context	BTC + 流动性 + 哈希带 + 难度 + 动量
macro.snapshot	美联储资产负债表、M2、国债收益率、美元强弱、净流动性
cross.correlations	BTC 与宏观指标的相关性矩阵
btc.pulse	价格、24 小时变动、比特币市值占比
btc.grid-stress	Epoch 进度及难度调整预测

基础版 - $19.99/月（14 项简报）

简报	描述
btc.momentum	200 日移动平均线支撑位/阻力位，以及 7 天/30 天/90 天动量和百分位排名
macro.liquidity	流动性指标及动量分析
btc.on-chain	算力、难度、交易量、活跃地址
cross.breadth	SPY、QQQ 和 IWM 的市场广度，以及 Bitcoin 与它们各自的相关性
btc.miner-survival	哈希价格温度计及矿工压力评分
btc.etf-flows	BTC 现货 ETF 每日净流入、总 AUM，以及各发行方明细
macro.auctions	国债拍卖需求：各期限国债和债券最近一次拍卖的买家构成，与该期限此前 12 次拍卖进行对比；并列出已公布和计划举行的下一场拍卖
bonds.context	谁在持有美国国债：外国投资者的净买入量（财政部 TIC）、一级交易商 13 周持仓变化（纽约联储）和投机者的 10 年期国债期货持仓（CFTC），各自与历史数据对比，并附上 10 年期收益率和三只债券基金
eth.context	Ether 的现状：CoinGecko 提供的价格和全球 24 小时交易量、相对 200 日均线的距离、Lido 的 stETH APR、CFTC 的 CME Ether 持仓情况，以及 OKX 的资金费率
commodities.gold	黄金基金（GLD）和世界银行公布的黄金月度价格，以及 10 年期实际利率、美元基金、CFTC 的 COMEX 黄金持仓情况和矿业公司基金，并分别列出它们与 GLD 的测算关联
commodities.silver	白银基金（SLV）和世界银行公布的白银月度价格，以及 CFTC 的 COMEX 白银持仓情况、黄金基金、美元基金、铜基金、白银矿业公司基金和 10 年期实际利率，并分别列出它们与 SLV 的测算关联
commodities.copper	铜期货基金（CPER）和世界银行公布的铜月度价格，以及 CFTC 的 COMEX 铜持仓情况、美元基金和黄金基金，并分别列出它们与 CPER 的测算关联
commodities.wheat	小麦期货基金（WEAT）和世界银行公布的美国软红冬麦月度价格，以及 CFTC 的 CBOT 小麦持仓情况、美元基金和 WTI 现货价格，并分别列出它们与 WEAT 的测算关联
macro.calendar	根据各发布方自己的日历，列出即将举行的主要美国经济数据发布、FOMC 和 ECB 决议、FOMC 会议纪要及财政部附息国债拍卖日期（本周或下一场），并附上最新公布的美国就业报告、CPI 和每周初请失业金人数，以及每项数据修订的内容

专业版 - $49.99/月（13 份简报）

简报	描述
btc.full	比特币完整分析：宏观叠加、动量、百分位数、相关性和叙事
btc.factors	BTC 价格变动的多因子归因
cross.regime	市场状态分类（扩张、收缩、过渡），并结合 USDT 主导率
fx.liquidity	欧元/美元、美元/人民币和美元强势程度，以及净流动性和比特币相关性
btc.energy	纳入天然气投入压力的生产成本模型
btc.treasury	基于 SEC 文件的企业比特币资金储备情报
macro.rates	各期限的美国国债平价收益率曲线，从 1M 到 30Y；盈亏平衡通胀率、5y5y 远期利率、德国 10Y 收益率
cross.ai-compute	AI 算力和电力链：美国电网需求与一年前同期对比、基于 SEC 文件的矿工 AI 托管协议、托管业务与采矿业务的每兆瓦对比
commodities.energy-basket	根据 EIA 周报，将美国石油和天然气库存与五年常态水平对比；包含 WTI、Brent 和 Henry Hub 现货价格、Brent 与 WTI 价差，以及 WTI 已实现波动率
bonds.full	谁在持有美国国债：外国投资者、一级交易商和投机者各自相对于自身历史水平的情况；美联储自身的国债持仓、公众持有的债务、最大的外国持有者、会改变各项读数的因素以及下一份报告的发布时间
commodities.oil-producers	原油及其覆盖范围内的美国生产商：能源篮子的状态、EIA 提供的 WTI 和 Brent 现货价格；然后是各家综合性大型企业、生产商、炼油商和两家油田服务公司，包含股价、1、3 和 12 个月涨跌幅（与 WTI 对比），以及测得的 90 天 WTI 相关性
commodities.gold-miners	黄金基金（GLD，代表股价而非金价）和世界银行提供的黄金月度价格，与覆盖范围内的美国黄金和白银矿商、特许权使用费及流媒体公司并列；包含各自股价、1、3 和 12 个月涨跌幅（与 GLD 对比），以及测得的 90 天 GLD 相关性
commodities.grains-agribusiness	小麦期货基金（WEAT，并非小麦价格）和世界银行提供的美国软红冬小麦月度价格，与覆盖范围内的美国谷物贸易商和加工商、种子及作物养分公司、农机制造商和农田 REIT 并列；包含各自股价、1、3 和 12 个月涨跌幅（与 WEAT 对比），以及测得的 90 天 WEAT 相关性

公司简报

equities.company 每次读取一家上市公司，由其自身报告组成（向其本国市场监管机构提交的文件；对于印度公司，则为其自行发布的业绩），每项数据均注明日期和来源：美国公司适用于 Basic 及以上套餐，日本、韩国和印度公司适用于 Pro 及以上套餐。它只作描述，绝不会告诉你该怎么做。

• 指定公司，使用 entity：美国股票代码或 CIK（NVDA）、日本证券代码（7203）、韩国股票代码（005930）、印度公司的 ISIN（INE018A01030），或在英国提交文件的公司或欧洲公司的 LEI（2138002P5RNKC5W2JZ46）。
• 不确定代码？ 使用 search 调用 list_briefings，例如 "Toyota earnings"：答案会列出符合条件的已覆盖公司，以及每家公司的 entity 值，供你传入。
• 读取一个部分，使用 block 并从以下 11 个部分中选择一个；也可以省略该参数以获取完整简报。每个部分计为一次调用；完整简报则按其包含的每个部分分别计费。部分仅提供当天的数据。

get_context(briefing="equities.company", entity="7203")
get_context(briefing="equities.company", entity="NVDA", block="valuation")

部分（block）	内容
header	公司简介、包含该公司的指数及其日期，以及同行概览
what_changed	公司近期提交的文件
situations	标记出的情况及各自的严重程度
against_guidance	将公司自行公布的预期与实际报告的数据并列展示（仅限美国公司）
numbers	损益表、资产负债表和现金流历史，包含增长数据及公司的自身历史
segments	业务、产品和地域划分（美国和日本）
valuation	收盘价、市值、市盈率、市净率和市销率、企业价值倍数以及自由现金流收益率；每项均包含一年前的数据和自身历史（收盘价来自 StockAnalysis.com）
capital_structure	债务、流动性和到期情况
quality	盈利质量和流动性，包括应计比率、现金转换率、流动比率、速动比率和现金比率、营运资本、资产周转率，以及销售、库存和应付账款周转天数
profitability	回报和现金创造能力，包括自由现金流、自由现金流利润率及每股自由现金流、EBITDA、净资产收益率、资产收益率和投入资本回报率、派息率及有效税率
news	已提交的新闻

示例提示词

连接后，可以尝试以下提示词：

• “连接到 PreReason”
• “显示宏观概览”
• “国债收益率如何？美联储最近做出了什么决定？”
• “NVIDIA 公布了什么？它在同行中排名如何？”
• “比特币与股票和美元的走势有何关联？”
• “列出可用的简报”

故障排除

“Server disconnected” 错误

• 确认已安装 Node.js 18+：node --version
• 检查 API 密钥是否以 pr_live_ 开头
• 完全退出 Claude Desktop（系统托盘 > 退出），然后重新打开

工具未显示

• 编辑配置后重启 Claude Desktop
• 验证 JSON 语法：node -e "JSON.parse(require('fs').readFileSync('path/to/config','utf8'))"

Windows：“'C:\Program' is not recognized”

如果仍看到此错误，请确认你使用的是 env 块（而非 --header 参数），如上文“快速开始”所示。如果问题仍然存在，请全局安装并使用 node：

1. 运行：npm install -g @prereason/mcp
2. 使用以下配置（将 YOUR_USER 替换为你的 Windows 用户名）：

{
  "mcpServers": {
    "prereason": {
      "command": "node",
      "args": [
        "C:\\Users\\YOUR_USER\\AppData\\Roaming\\npm\\node_modules\\@prereason\\mcp\\bin\\cli.js"
      ],
      "env": {
        "PREREASON_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

get_context / get_metric 上的身份验证错误

• list_briefings、list_metrics 和 get_health 无需密钥即可使用
• get_context 和 get_metric 需要有效的 API 密钥；get_changes 需要 Basic 或 Pro 套餐的密钥
• 在 prereason.com/signup 获取免费密钥

其他 MCP 客户端

如果你的客户端支持远程 HTTP 服务，请使用上文的 快速入门选项 2。stdio 桥接包仅适用于需要 stdio 传输的客户端（例如 Claude Desktop）。

CLI 用法

# No key: the bridge asks for access and prints one link to approve
npx @prereason/mcp

# Ask for access now, save the key, exit (useful before a first run)
npx @prereason/mcp --login

# Forget the saved key
npx @prereason/mcp --logout

# Use a key from the environment (never asks)
PREREASON_API_KEY=pr_live_... npx @prereason/mcp

# Name the app the bridge runs in, so your dashboard names the connection
PREREASON_CLIENT=claude-desktop npx @prereason/mcp

# --header (backward compatible), a custom credentials file, a custom endpoint
npx @prereason/mcp --header "Authorization:Bearer YOUR_API_KEY"
npx @prereason/mcp --credentials-file /path/to/credentials.json
PREREASON_URL=https://custom.endpoint/mcp npx @prereason/mcp

npx @prereason/mcp --help

密钥优先级：先是 PREREASON_API_KEY，然后是 --header，再然后是凭据文件（~/.prereason/credentials.json、PREREASON_CREDENTIALS_FILE 或 --credentials-file），最后是认领流程。该文件存储密钥以及签发该密钥的认领信息，不存储认领令牌。在 macOS 和 Linux 上，目录会以 0700 权限创建，文件则为 0600；Windows 没有权限位，因此该文件与其他凭据存储一样，依赖用户配置文件目录的权限。

Claude Desktop 扩展（.mcpb）

mcpb/manifest.json 将同一桥接程序描述为可一键安装的 Claude Desktop 扩展，密钥可选。要构建此扩展包：运行 npm install --omit=dev，然后在包目录中运行 npx @anthropic-ai/mcpb pack .，并双击生成的 .mcpb 文件进行安装。提交到 Claude 目录需通过桌面扩展表单，是否提交由发布者决定。

无依赖项

该桥接程序自带传输机制，不会安装任何内容。运行 npm ls 只会输出一行；npx @prereason/mcp 会下载一个 23 KB 的 tarball 并启动；安全审查需要检查的代码就在此存储库中。

它过去依赖 @modelcontextprotocol/sdk 中的两个类：一个 stdio 传输类和一个 Streamable HTTP 客户端。这会引入 91 个包，占用 25 MB 磁盘空间，其中几乎全是 SDK 的服务端部分：Express、Hono、CORS、速率限制器、OAuth 客户端和架构验证器，转发器从未调用过其中任何一个。lib/stdio.js 和 lib/streamable-http.js 替代了桥接程序使用的这两个类，保留其消息帧格式和回调，并由 test/ 下的测试套件覆盖。

链接

• 文档
• 注册
• API 发现
• 服务条款
• 隐私政策

隐私政策

有关数据处理实践，请参阅 prereason.com/privacy。

许可证

MIT