Signal Feed API: market regime

signal-feed-mcp

Signal Feed API 的 MCP 服务：为交易 Agent 提供每日市场状态背景信息。它只回答一个问题：当前市场是风险偏好还是风险规避？当天的报告按次付费，使用 x402（在 Base 上支付 0.10 USDC，含 VAT）。较早的报告、规则和完整结果记录均可免费获取。

每天一份报告，对所有购买者内容相同，包含五个基于规则的市场状态标签：

• BTC 趋势过滤器（收盘价与 SMA20/50 的比较）
• 9 种山寨币的趋势评分
• 美国股市状态（SPY 与 SMA200 的比较、VIX/VIX3M 期限结构）
• SPY RSI(2) 状态
• MSTR BTC 过滤器

诚信说明。 这些规则来自卖方自己的虚拟（PAPER）研究账户。首份报告于 2026-10-26 发布，因此没有历史业绩记录。这些内容仅作背景参考，不构成投资建议。每份报告都会进行哈希承诺、通过 OpenTimestamps 锚定，且发布后绝不修改；完整的 PAPER 结果（包括亏损）均公开。

安装

Python 3.10+。

pip install signal-feed-mcp
# or run without installing:
uvx signal-feed-mcp

Claude Desktop 和其他 MCPB 宿主也可以安装单文件包（signal-feed-mcp-<version>.mcpb），该包通过 uv 运行，并会在设置中提示输入可选的钱包密钥。

配置 MCP 客户端

Claude Desktop、Claude Code、Cursor 或任何 stdio MCP 客户端：

{
  "mcpServers": {
    "signal-feed": {
      "command": "signal-feed-mcp",
      "env": {
        "X402_BUYER_PRIVATE_KEY": "<optional: key of a wallet holding a little USDC on Base>",
        "SIGNAL_FEED_MAX_PAID_CALLS": "3",
        "SIGNAL_FEED_PREFLIGHT": "block"
      }
    }
  }
}

不设置 X402_BUYER_PRIVATE_KEY 时，所有免费工具均可使用。只有 get_latest_issue 会被禁用，并说明原因。请使用专用钱包，且钱包中只存放你愿意花费的金额。

工具

工具	返回内容	费用
get_catalog	指标及其规则、时间表、价格、免费和付费访问方式	免费
get_schema	单份报告的封闭 JSON Schema	免费
list_issues	账本：每份报告的日期及其载荷 SHA-256	免费
get_delayed_issue(issue_date)	至少已发布 7 天的报告；会重新计算其哈希，并与报告及账本中的记录进行核对	免费
get_results_record(indicator?)	每项指标背后账户的完整每日 PAPER 结果，包括亏损	免费
get_deviations	已注明日期的错误、服务中断及其他偏差	免费
get_disclosures	发布方的持仓及利益冲突	免费
get_payment_offer	当前有效的 x402 付费选项，不会扣款	免费
get_latest_issue	今日报告、收据、结算交易及哈希核验结果	0.10 USDC

付款安全

• 你的钱包密钥仅从此进程的环境中读取。它用于通过官方 x402 客户端在本地签名，绝不会记录日志、出现在工具输出中或发送到任何地方。卖家永远不会看到它。
• 签名前，除非报价完全符合以下条件，否则客户端会拒绝：
  • 方案为 exact；
  • 网络为 Base 主网（eip155:8453）；
  • 资产为 USDC：0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913；
  • 金额为 100000（0.10 USDC）；
  • 适用于 https://signals.agenttrustapi.com/v1/feed/latest；
  • 收款方为已公布的商户 0x8b0ad0CE12Ac86822c4d5dE442F5e445d14F9183（可通过 SIGNAL_FEED_EXPECTED_PAY_TO 覆盖）。
• x402 客户端的支出控制将每笔付款上限设为 0.10 USDC。
• 付款后，收据哈希、重新计算的哈希和公开账本中的哈希必须全部匹配。
• **会话预算：**每个服务进程最多进行 SIGNAL_FEED_MAX_PAID_CALLS 笔付款（默认值为 3）。每笔付款都会在尝试前计入。被下方预检拒绝的付款不计入。
• **独立预检（可选）：**启用 SIGNAL_FEED_PREFLIGHT 后，每笔付款都会先发送到 Agent Trust API 的付款预检接口（POST /v1/preflight/payment， 同一卖家；截至撰写本文时不收费）。该接口会针对这笔确切的付款返回 ALLOW、REVIEW 或 BLOCK。
  • **检查内容：**x402 报价是否一致，以及收款方是否与资源绑定。如果你提供已签名的委托（SIGNAL_FEED_AUTHORITY_FILE），它还会检查该 Agent 是否有权进行这笔确切的付款。
  • 模式：block 模式下，ALLOW 或 REVIEW 时付款，BLOCK 时拒绝。allow-only 模式下，仅在 ALLOW 时付款。
  • **默认拒绝：**如果 Agent Trust 无法访问，或返回任何意外内容，则不会进行签名。
  • **发送内容：**Agent ID、付款信息、402 报价和可选的委托。绝不会发送你的密钥。
  • **范围：**它检查的是付款，而不是数据对你是否有用。这不是保险。

向购买此信息流的任何 Agent 建议的支出策略

• 仅向 https://signals.agenttrustapi.com/v1/feed/latest 付款，收款方仅限已公布的商户，且只能使用 Base 上的 USDC。
• 每项内容最多支付 0.10 USDC，每天最多支付 0.20 USDC。每天获取一项新内容就足够了，日期会显示在报价中。
• 切勿盲目重试失败的付款。遇到非 200 响应或重复扣款时应停止，并根据已公布的政策申请退款。

环境

变量	默认值	含义
X402_BUYER_PRIVATE_KEY	未设置	付费工具使用的钱包密钥（可选）
SIGNAL_FEED_MAX_PAID_CALLS	3	每个服务进程允许的付款次数
SIGNAL_FEED_EXPECTED_PAY_TO	已公布的商户	客户端唯一会向其付款的收款方
SIGNAL_FEED_BASE_URL	https://signals.agenttrustapi.com	API 基础 URL
SIGNAL_FEED_PREFLIGHT	off	off、block 或 allow-only（Agent Trust 付款预检）
SIGNAL_FEED_AUTHORITY_FILE	未设置	预检使用的委托（authority envelope）JSON 文件路径
SIGNAL_FEED_AGENT_ID	signal-feed-mcp	发送给预检接口的 Agent ID
SIGNAL_FEED_PREFLIGHT_URL	Agent Trust 生产环境	预检端点

优惠

对于将此信息流用作决策前上下文的开源 Agent，提供设计合作伙伴退款和 100 USDC 的开发奖励。条款：https://signals.agenttrustapi.com/offers。

更多信息

• 目录和规则：https://signals.agenttrustapi.com/v1/catalog
• 面向大模型 Agent：https://signals.agenttrustapi.com/llms.txt
• OpenAPI：https://signals.agenttrustapi.com/openapi.json
• 条款、隐私、风险和退款：https://signals.agenttrustapi.com/legal/terms

开发

pip install -e ".[dev]"
pytest && ruff check .

测试使用模拟 API 离线运行，不会发出网络请求，也不会进行付款。

许可证

MIT © 2026 Agrobroker LTD, Burgas, Bulgaria。联系方式：[email protected]

mcp-name: io.github.DinevDecor/signal-feed-mcp