HODLXXI Read-Only

HODLXXI Read-Only MCP

許可リストに登録された、機械可読な HODLXXI の信頼性サーフェス 26 種をラップする、公開リモート MCP サーバーおよびスタンドアロンの FastMCP パッケージです。

公開リモートサーバー

リモートサーバーをサポートする任意の MCP ホストで、この Streamable HTTP エンドポイントを使用できます。

https://hodlxxi.com/agent/mcp

API キーや OAuth フローは不要です。サーバーは公開されており、読み取り専用です。

機械可読な検出情報：

https://hodlxxi.com/.well-known/mcp.json
https://hodlxxi.com/.well-known/agent.json
https://hodlxxi.com/agent/capabilities

互換性のあるクライアントはセッションを初期化し、ちょうど 26 個のツールを一覧表示して、次のようなツールを呼び出せます。

• hodlxxi_get_agent_discovery
• hodlxxi_get_capabilities
• hodlxxi_get_chain_health
• hodlxxi_get_reputation
• hodlxxi_get_attestations
• hodlxxi_get_operator_continuity
• hodlxxi_get_receipt
• hodlxxi_verify_receipt

正規の MCP Registry メタデータは、リポジトリのルートにある server.json に io.github.hodlxxi/hodlxxi-readonly という名前で保存されています。

セキュリティ境界

• 固定されたアップストリームのオリジン：https://hodlxxi.com
• 固定されたエンドポイント列挙型。汎用 URL ツールはありません
• 許可リストに登録されたアップストリームのランタイムサーフェスに対する GET のみのアクセス
• リダイレクトは無効
• アップストリームのタイムアウトは 10 秒
• レスポンスの上限は 2 MiB
• JSON および application/linkset+json のみ
• 識別子とページネーションの厳格な検証
• Flask のインポート、データベースアクセス、ウォレットアクセス、LND アクセス、キー、シークレット、環境変数の読み取り、支払いの開始、レシートの作成、書き込み呼び出しはありません
• 専用の systemd サイドカーを使用します。Flask モノリスは MCP ツールを実行しません
• 公開 nginx ルートはループバックのサイドカーにのみプロキシします

GET /agent/jobs/<job_id> と GET /agent/readiness/self-scan は、サーバーの状態を変更する可能性があるため、意図的に除外されています。

独立した検証

リモートの本番環境経路は、外部の macOS クライアントおよび Claude カスタムコネクターを通じて検証済みです。

external client -> HTTPS -> nginx -> loopback MCP sidecar -> public HODLXXI runtime surfaces

検証では、MCP の初期化、tools/list、および capabilities、chain health、reputation へのライブ呼び出しが完了しました。docs/MCP_CLIENT_VALIDATION.md を参照してください。

開発

python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[test]"
pytest -q

stdio で実行

hodlxxi-mcp

同等の設定：

python -m hodlxxi_mcp

ローカルのクライアント設定では、MCP ホストに仮想環境の実行ファイルを指定し、stdio トランスポートを使用してください。

localhost Streamable HTTP でサイドカーを実行

hodlxxi-mcp-http

サイドカーのエンドポイントは次のように固定されています。

http://127.0.0.1:8765/mcp

サイドカーのトランスポートは、ループバック、ステートレスな JSON レスポンス、Host/Origin 保護、および同じ 26 個の読み取り専用ツールに意図的に制限されています。公開は、強化された本番用リバースプロキシが別途処理します。