Verum Signal

Verum Signal MCP Server

LLM エージェントに、Verum Signal の政治討論報道を提供する MCP サーバーです。候補者が述べた主張、その発言者、および各主張の評価を確認できます。また、ニュースメディアが報じた主張も検索できます。Verum Signal API キーが必要です。

ツールの機能

ツール	返される内容	明示的に返さないもの
list_debates	利用可能な討論の一覧。主張の件数、日付、ステータスが含まれます。	主張そのものは含まれません。取得するには get_debate_verdicts を呼び出してください。
get_debate_verdicts	1 つの討論で評価されたすべての主張。発言者、評価、および評価がまだ暫定かどうかが含まれます。完全な結果を得られるよう、自動的にページ分割して取得します。	暗黙に結果を切り詰めることはありません。討論の規模が大きく内部の安全上限に達した場合、部分的な結果を黙って返すのではなく、応答に 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

次に、上記の設定では args を指定せず、"command": "verumsignal-mcp" を使用します。

クローンから実行する場合： 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 クライアントでも同じコマンド、引数、環境を使用します。

動作を確認する： エージェントに「Verum Signal が扱っている討論を教えてください」と尋ねます。正しく接続されたサーバーは、日付と主張の件数を含む討論の一覧を返します。認証エラーが表示される場合はキーを確認してください。接続エラーが表示される場合は、サーバーの実行環境から api.verumsignal.com への HTTPS アウトバウンドアクセスが許可されていることを確認してください。

キーの取得

キーは Verum Signal のアカウント保有者に発行されます。verumsignal.com/developers をご覧ください。

データの境界

評価の根拠は API から取得できません。この制限は構造的に実現されています。API のクエリが評価の根拠として書かれた文章を取得することはなく、API にデータを提供するキャッシュにも保存されません。これは後から適用するフィルターではなく、このサーバーがアクセスできるデータに、そもそも含まれていません。

このサーバーが送信するもの：各ツール呼び出しに対して、api.verumsignal.com（または運用者が設定した VS_API_BASE）への認証済み GET リクエストを送信します。

呼び出し元のエージェントに返すもの：その API 呼び出しが返す内容をそのまま返します。

このサーバーが一切扱わないもの：設定された API ホスト以外へのネットワーク接続、ローカルファイルの読み書き、テレメトリーやアナリティクスは一切ありません。使用するのは Python 標準ライブラリ（json、os、sys、urllib）のみです。

キーの取り扱い

VS_API_KEY は環境変数から読み込まれ、ハードコードされることはありません。サーバーはログを一切記録せず、2つある例外処理のいずれでも、例外オブジェクト自体を文字列化するだけで、キーを含む可能性のある変数を文字列化することはありません。キーが出力、ログ、ファイルに渡るコード経路はありません。

キーは次の2つの方法で指定できます。

1. MCP クライアントの設定ファイルで指定する方法。上記の例のとおりです。このファイルには有効な認証情報が含まれるため、他の秘密情報ファイルと同様に保護してください（アクセス権を制限し、バージョン管理にコミットしないでください）。
2. 環境変数として指定する方法。シェルまたはシークレットマネージャーで設定します。変数をどこで設定したかにかかわらず、サーバーは環境変数を読み込みます。

レート制限とクォータ

キーのティアによって、1分あたりのレートと月間クォータが決まります。現在の制限については、verumsignal.com/developers をご覧ください。各ツールの応答には、両方の残量（rate_limit_remaining、monthly_quota_remaining）を示す _quota フィールドが含まれているため、429 が返されてから気づくのではなく、エージェントは次の呼び出しの前に確認できます。

レート制限にはスライディングウィンドウではなく、固定された1分間の実時間ウィンドウが使われます。そのため、1分の境界をまたぐバーストでは、名目上の1分あたりのレートを短時間超える場合があります。上限は設定されており、まずはこちらからお知らせします。

バージョン管理

このサーバーはv0.2.0です。1.0 より前のバージョンであることを正直に示しています。API バージョン v1 を対象としています。評価には、評価時に適用された方法論のバージョンが記載されています。バージョン履歴については CHANGELOG.md をご覧ください。

既知の制限事項

• アウトレット単位のスコアは提供されません。 ツールが返すのは個別の主張とその評価のみです。
• 評価の理由は提供されません。 これは意図的な境界です。上記の「データ境界」をご覧ください。
• ディベートの評価は暫定的な場合があります。 各ディベートの主張には、評価がまだ暫定的かどうかが記載されます。ディベート後のレビューを経て、評価が確定します。
• データの鮮度： API のキャッシュは5分ごとに更新されます。このサーバーのデータの鮮度は、そのキャッシュと同じです。