hogswap-mcp

hogswap-mcp

AI エージェントに HOGSWAP を公開する MCP サーバーです。DEX 集約型の見積もり、未署名のスワップ構築、人手を介さない API キーの自己登録、そして目玉機能の pay_x402_invoice を提供します。この機能では、正確な出力額を指定したルーターのスワップを介して、保有する任意の 1〜4 種類のアセットで、Algorand 上で決済される任意の x402 請求書を支払えます。API リファレンス： hogswap-v1.liquihog.dev/reference。 エージェントではなくアプリを構築する場合は、公式 SDK をご利用ください： hogswap-js-sdk（npm） および hogswap-py-sdk（PyPI）。

厳格なノンカストディアル方式です。トランザクションを生成するすべてのツールは、未署名のグループを返します。ご自身のウォレットツールで署名し、ご自身で送信してください。ニーモニックや秘密鍵をツールに渡さないでください。

実行（stdio）

npm install
HOGSWAP_API_KEY=hsk_... node src/index.mjs        # key optional

Claude Code：claude mcp add hogswap -e HOGSWAP_API_KEY=hsk_... -- node <abs-path>/src/index.mjs

環境変数	説明
HOGSWAP_API_URL	API のベース URL（デフォルト：https://hogswap-v1.liquihog.dev）
HOGSWAP_API_KEY	hsk_ ベアラーキー。register_agent / verify_registration ツールで自己発行できます

ツール

無料（キー不要）：list_payable_assets、get_quote、register_agent、 verify_registration。get_quote では省略可能な max_legs（1〜16）を指定して、ルートの合計レッグ数を制限できます。分割分も含まれます。これは、ご自身のリソース予算内でルートを再実行するために使用します。

🔑 HOGSWAP API キーが必要です（HOGSWAP_API_KEY を設定するか、register_agent → 署名 → verify_registration で自己発行）：build_swap、 pay_x402_invoice、get_credit_offer、get_balance、および監視ツールの set_watch / list_watches / delete_watch（サーバー側で常時有効な価格／目標アラート。無料ですが、キーごとに名前空間が分かれます）。キーがない場合、これらは構築を行わず、認証エラーを返します。

監視の通知は数値のみのヒントです。通知が発生したら、get_quote で再見積もりしてください。MCP からは list_watches をポーリングします。MCP の外部では、サーバーが GET /watches/stream の SSE を通じてイベントをプッシュします。

pay_x402_invoice は 2 つのグループ（スワップ、次に支払い）を返します。すべてのトランザクションに一度に署名し、グループを順番に送信してください。スワップのオンチェーン下限によって、支払いに必要な資金が確保されます。HOGSWAP クレジットのチャージに対する 402 オファー自体が x402 請求書です。その accepts[0]（note ノンスを含む）をそのまま pay_x402_invoice に渡すと、任意のアセットでクレジットを購入できます。

リモート（ローカルプロセス不要）

同じ 12 個のツールが、MCP Streamable HTTP 経由で https://hogswap-v1.liquihog.dev/mcp/ に提供されています。HOGSWAP API 自体がホストするため、ローカルプロセスは不要です。末尾のスラッシュを付けてください。スラッシュのない /mcp は /mcp/ に 307 リダイレクトされ、呼び出しごとに余分なラウンドトリップが発生します。リモート対応の MCP クライアントから接続し、キーを Authorization: Bearer hsk_... として渡してください（Claude API コネクターの authorization_token がこれを行います）。

スモークテスト

HOGSWAP_API_KEY=hsk_... \
SMOKE_PAY_TO=<any USDC-opted addr> node test/smoke.mjs        # stdio

HOGSWAP_API_KEY=hsk_... \
SMOKE_PAY_TO=<any USDC-opted addr> node test/smoke-remote.mjs # remote

どちらもデフォルトではライブ API に接続します。別のインスタンスを指定するには、HOGSWAP_API_URL（stdio）または MCP_URL（リモート）を設定してください。読み取りと構築のみを行い、署名やブロードキャストは行いません。