Verum Signal

Verum Signal MCP 服务

一个 MCP 服务，为大模型 Agent 提供 Verum Signal 的政治辩论报道：候选人提出了哪些主张、每项主张由谁提出，以及每项主张的评级。它还可以搜索新闻媒体报道的主张。需要 Verum Signal API 密钥。

工具的作用

工具	返回内容	明确不会
list_debates	可用辩论及其主张数量、日期和状态。	包含主张本身——如需获取，请调用 get_debate_verdicts。
get_debate_verdicts	一场辩论中所有已评级的主张，以及发言者、评级和评级是否仍为暂定状态。自动分页，直至获取完整结果。	静默截断结果。如果辩论规模过大，触及内部安全上限，响应会明确包含 truncated: true 标记，而不会悄悄返回部分结果。
list_recent_claims	新闻媒体报道的主张及其评级。传入 q 可查找特定主题的主张；可按媒体或评级筛选；不传入 q 时，按时间从近到远排列。	返回媒体归因于他人的引用主张，或任何媒体的总体评分。
get_api_status	语料库统计信息：语料库包含多少内容、涵盖哪些内容，以及内容的时效性。	包含单条主张的详情——如需获取，请调用其他工具。

完整的参数架构定义在工具本身中（verumsignal_mcp/server.py），任何 MCP 客户端也都可以直接显示这些定义。此表仅为摘要；工具定义具有权威性。

安装与配置

需要 Python 3.9+，且无需第三方依赖。

使用 uv（无需预先安装任何内容）：

{
  "mcpServers": {
    "verum-signal": {
      "command": "uvx",
      "args": ["verumsignal-mcp"],
      "env": { "VS_API_KEY": "vs_live_..." }
    }
  }
}

使用 pip：

pip install verumsignal-mcp

然后在上面的配置中使用 "command": "verumsignal-mcp"，无需设置 args。

从克隆的仓库运行： git clone https://github.com/brittbart/verumsignal-mcp.git，并使用 "command": "python3"、"args": ["/absolute/path/to/mcp_server.py"]。

这些示例适用于 Claude Desktop 的 claude_desktop_config.json；其他 MCP 客户端使用相同的命令、参数和环境。

验证是否正常运行： 询问你的 Agent：“Verum Signal 涵盖了哪些辩论？” 正确配置的服务会返回包含日期和主张数量的辩论列表。如果看到身份验证错误，请检查密钥；如果看到连接错误，请确认运行服务的环境允许通过 HTTPS 连接到 api.verumsignal.com。

获取密钥

密钥发放给 Verum Signal 账户持有人。请参阅 verumsignal.com/developers。

数据边界

API 不提供评级理由，并且这一限制是通过结构设计确保的：API 查询永远不会获取评级背后的书面理由，为 API 提供数据的缓存也永远不会存储这些理由。这不是事后应用的过滤器——此服务能够访问的数据中根本不包含这些内容。

此服务发送的内容：每次调用工具时，都会向 api.verumsignal.com（或由运营者配置的 VS_API_BASE）发送经过身份验证的 GET 请求。

此服务返回给调用 Agent 的内容：该 API 调用返回的所有内容。

此服务绝不会接触的内容：此服务不会与配置的 API 主机以外的任何对象建立网络连接，不会读取或写入本地文件，也不包含任何形式的遥测或分析功能。它仅使用 Python 标准库（json、os、sys、urllib）。

密钥处理

VS_API_KEY 从环境中读取，绝不会硬编码。服务没有任何日志记录，其两处异常处理逻辑都只会将异常对象本身转换为字符串，绝不会处理任何可能包含密钥的变量。密钥无法通过任何代码路径进入输出、日志或文件。

你可以通过两种方式提供密钥：

1. 在 MCP 客户端的配置文件中，如上所示。该文件随后会包含有效凭证，应像其他机密文件一样妥善保护（限制权限，且不要提交到版本控制）。
2. 作为环境变量，由 shell 或密钥管理器设置。无论该变量在哪里设置，服务都会读取环境中的值。

速率限制与配额

你的密钥所属等级决定了每分钟速率限制和月度配额；当前限制请查看 verumsignal.com/developers。每个工具响应都包含一个 _quota 字段，显示两项剩余量（rate_limit_remaining、monthly_quota_remaining），因此 Agent 可以在再次调用前检查，而不必等到收到 429 错误才发现限制。

速率限制器使用固定的一分钟墙上时钟窗口，而非滑动窗口，因此跨越分钟边界的突发调用可能会在极短时间内超过名义上的每分钟速率限制。超出范围是有限的，我们会先通知你。

版本管理

此服务当前版本为 v0.2.0，这是一个诚实的 1.0 前版本号。它面向 API v1 版本。评分会标明其采用的方法论版本。版本历史请参阅 CHANGELOG.md。

已知限制

• 不提供媒体层面的评分。 工具只返回单条主张及其评分。
• 不提供评分理由。 这是有意划定的边界——请参阅上文“数据边界”。
• 辩论评分可能是暂定的。 每条辩论主张都会说明其评分是否仍为暂定；辩论后的审查完成后，评分才会定稿。
• 数据新鲜度： API 缓存每 5 分钟刷新一次。此服务的数据新鲜度与该缓存完全一致。