Capitol Ledger

Capitol Ledger MCP

AI エージェント向けの議会議員の株式開示に関するリサーチを読み取り専用で提供します。米国下院の公式開示を検索し、保存された合成開示台帳ポートフォリオを確認して、情報源と時期の背景を踏まえてポートフォリオの変化を説明します。

パイロットアクセスを申請 · API ドキュメント · PyPI パッケージ · 公式 MCP レジストリ · 公開されている架空のサンプル · 方法論

アクセス

アダプターはオープンソースです。ホスト型データ API の利用には、承認済みの Capitol Ledger API キーが必要です。上記のリンクから、招待制の14 日間無料パイロットを申請してください。承認されたパイロットアカウントでは、UTC の 1 日あたり、すべてのキーで共有される認証済みリクエスト数の上限が 1,000 件に設定されています。支払い情報の登録や、自動的な有料プランへの移行はありません。申請を送信しても、アクセスが許可されたり、ニュースレターに登録されたりするわけではありません。

公開 JSON サンプルは架空のもので、キーは不要です。レスポンスの形式を確認するのに便利ですが、実際の開示情報や最新データではありません。

インストール

Python 3.12 以降が必要です。公開されている PyPI パッケージをインストールしてください。

pip install capitol-ledger-mcp

永続的にインストールせずに実行する場合：

uvx --from capitol-ledger-mcp capitol-ledger-mcp

代わりに、この公開リポジトリからインストールする場合：

pip install 'git+https://github.com/joalbrecht/capitol-ledger-mcp.git'

MCP クライアントに接続する

インストール済みのアダプターでは、次のローカル stdio 設定を使用してください。

{
  "mcpServers": {
    "capitol-ledger": {
      "command": "capitol-ledger-mcp",
      "env": {
        "CAPITOL_LEDGER_API_URL": "https://capitol-ledger.com",
        "CAPITOL_LEDGER_API_KEY": "YOUR_APPROVED_API_KEY"
      }
    }
  }
}

プレースホルダーはローカル環境で置き換え、キーはクライアントのシークレットストアに保管してください。共有プロンプト、URL、issue、公開リポジトリには記載しないでください。クライアントがコマンドを見つけられない場合は、インストール先の絶対パスを使用してください。

uvx を使用するクライアントでは、同じ env を設定したうえで、代わりに "command": "uvx" と "args": ["--from", "capitol-ledger-mcp", "capitol-ledger-mcp"] を使用できます。これはホスト型 HTTPS API を呼び出すローカル stdio サーバーです。ホスト型のリモート MCP エンドポイントではありません。ブローカーや取引口座の認証情報は不要です。

ツール

ツール	目的	パラメーター
search_disclosures	提出書類へのリンクと金額範囲を含めて、下院の株式開示を検索します	任意の ticker、side、available_after、as_of、limit、offset
get_portfolio	保存された合成台帳レポートの開始時／終了時の配分を取得します	任意の report_id、as_of
get_portfolio_changes	保存された期間の購入、売却、配分の変化を取得します	任意の report_id、as_of

接続後にできる質問の例：

• 過去 30 日間に開示された NVDA の購入を、情報源へのリンクとともに教えてください。
• 最新の保存済み合成開示ポートフォリオと、その期間を表示してください。
• そのレポートでは何が変わりましたか？同じレポート ID を使用してください。

検索期間のデフォルトは 30 日で、1 回の呼び出しにつき最大 100 行です。side には purchase、sale、exchange を指定できます。タイムスタンプにはタイムゾーンを含める必要があります。ページングで meta.next_offset を使用する場合は、返された as_of と available_after を再利用してください。同じ期間のポートフォリオとその変化を比較するには、report_id を固定してください。

対象範囲と解釈

• 下院のみです。 上院のデータは含まれません。
• 開示には遅れがあります。取引日、公開された届出の入手可能時期、データの収集時刻はそれぞれ異なります。新たに届出された開示を、たった今行われた取引として説明しないでください。
• 開示された金額は範囲であり、正確な取引額ではありません。合成台帳の値には中間値の推定を使用しています。
• ポートフォリオのスナップショットは、合成開示台帳を表すものであり、実際の議員の保有資産でも、Capitol Ledgerの執行可能な戦略ポートフォリオでもありません。 レポートは日次、週次、月次、または随時作成される場合があります。返された期間のメタデータを確認してください。
• ソース URL、計算メタデータ、鮮度、対象範囲に関する警告を保持してください。完全性は保証されません。過去のクエリでは、パーサーやソースの改訂履歴を完全にバージョン管理したアーカイブではなく、現在解析済みのレコードが使用されます。
• 調査データのみを提供します。個別の投資助言や注文の執行は行いません。
• パイロットアクセスは内部調査ワークフロー向けです。再配布や下流ユーザーへの提供については、Capitol Ledgerにお問い合わせください。コードのMITライセンスは、ホストされたデータの再配布権を付与するものではありません。

使用方法とエラー

3つのツールはすべて、APIのアカウント全体に適用されるクォータを使用します。使用状況と有効期限は、認証済みの GET /api/v1/account を使ってMCP外で確認できます（この確認でも1回分の呼び出しを消費します）。

• 401：キーが無効または失効しています。
• 403：アクセスが無効または期限切れです。
• 404：そのクエリに対する完了済みの保存レポートがありません。
• 422：パラメーターが無効です。
• 429：1日のクォータを使い切りました。HTTP APIの Retry-After ヘッダーを確認してください。

ツールがサブスクリプションを変更したり、キーをローテーションしたり、注文を送信したり、ローカルの製品データベースにアクセスしたりすることはありません。ローカル開発を除き、API呼び出しにはHTTPSが必要です。リダイレクト時に認証情報は引き継がれません。キーは環境認証情報であり、ツールの入力ではありません。モデル推論はMCPクライアントで実行されます。このアダプターは調査データを取得するだけです。

コンテナーのオプション

ディレクトリの安全性／品質チェックや、Dockerを優先するクライアント向けに、非ルートコンテナーが含まれています。認証情報は実行時に渡してください。イメージに埋め込まれることはありません。

docker build -t capitol-ledger-mcp .
docker run --rm -i -e CAPITOL_LEDGER_API_KEY -e CAPITOL_LEDGER_API_URL capitol-ledger-mcp

MCP stdioには -i を使用し、TTYは割り当てないでください。サーバーの起動とツールの一覧表示にはキーは不要ですが、データの呼び出しにはキーが必要です。

開発

pip install -e '.[dev]'
pytest
ruff check .

テストではHTTPをモックするため、実際の認証情報は不要で、APIクォータも消費しません。

公開

リリースワークフロー、PyPIの信頼されたパブリッシャーの設定、公式MCP Registryのメタデータについては、PUBLISHING.mdを参照してください。ディレクトリへの登録申請は、推奨や掲載承認の証拠にはなりません。

ライセンスとお問い合わせ

アダプターコードはMITライセンスです。ホストされたAPIへのアクセスとデータの権利は別途定められています。 お問い合わせ先：[email protected]。