1inch-mcp-server について
1inch MCP サーバーへの接続と、用途に応じた1inchドメイン別スキルの選択を支援するハブスキルです。利用可能なツール、認証手順、クライアント設定を説明します。
主な機能
- 01タスク別にドメインスキルを案内
- 02サーバーツールと利用条件の一覧
- 03認証フローの説明
- 04クライアント接続設定の案内
- 05ウォレット署名の動作説明
活用シーン
- 011inch MCP サーバー用クライアントの設定
- 02スワップや指値注文向けスキルの選択
- 03ウォレットや市場データの手順確認
- 04WalletConnect署名の設定
MCP 対応
クライアントを記載された Streamable HTTP エンドポイントに接続し、Claude Desktop 向けに stdio の選択肢も案内します。サーバーはスワップ、注文、製品 API、ドキュメント検索、認証のツールと、任意の WalletConnect、Aqua、デバッグ機能を提供します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ 1inch/ 1inch-ai --skill 1inch-mcp-serverインストール後、Claude Code で/1inch-mcp-serverを入力して読み込まれたか確認します。
同梱ファイルreferences/AUTH.mdreferences/TOOLS.md
詳細
1inch MCP サーバー
1inch MCP サーバーを接続するためのハブスキルです。各ドメインのワークフローの詳細は、対応するスキルで確認できます。
| スキル | 読み込むタイミング |
|---|---|
1inch-swap | クラシック/Fusion/クロスチェーンスワップ |
1inch-orderbook | 指値注文 |
1inch-wallet-data | product_api を介したポートフォリオ、残高、履歴、NFT、トークンメタデータ |
1inch-market-data | product_api を介したスポット価格、ガス価格、チャート |
1inch-infrastructure | product_api を介した Web3 RPC、トランザクションゲートウェイ、ドメイン |
1inch-walletconnect | ノンカストディアルウォレットのペアリング |
1inch-aqua | Aqua 戦略分析 |
1inch-debug | 組織スコープのリクエストログ検索 |
サーバー URL(本番環境)
https://api.1inch.com/mcp/protocol(ストリーミング可能な HTTP)
ツールの概要
| ツール | 認証 | 用途 |
|---|---|---|
search | 公開 | 1inch のドキュメントと API リファレンスを検索 |
list_examples / get_example | 公開 | SDK のサンプルパッケージ |
authenticate | 認証済み | 1inch Business ログインの開始または確認 |
swap | 認証済み | 見積もりとスワップの実行 |
orderbook | 認証済み | 指値注文の構築/作成/一覧表示/キャンセル |
product_api | 認証済み | 他の 1inch 製品 API の呼び出し |
walletconnect | 公開(任意) | WalletConnect を介したペアリング/署名/送信 |
aqua | 読み取りは公開(任意) | Aqua 戦略分析 |
debug | 認証済み(任意) | 組織スコープのリクエストログ検索 |
全パラメーターについては、references/TOOLS.md を参照してください。認証については、references/AUTH.md を参照してください。
HTTP 200 の初期化でも、認証状態は匿名のままです。有料ツールを使用する前に authenticate を呼び出してください。HTTP 401 が返された場合は OAuth を完了してから、再度 authenticate を呼び出してください。
署名フロー: walletconnect ツールが利用できる場合は、まずユーザーのウォレットを接続することをおすすめします。接続すると、swap、orderbook、aqua の書き込み操作はデフォルトで接続済みのウォレットを通じて実行され(execute のデフォルトは true)、ユーザーはウォレットアプリでプロンプトを承認するだけで済みます。1inch-walletconnect スキルを参照してください。
クライアントの設定(概要)
| クライアント | トランスポート | 設定 |
|---|---|---|
| Cursor | HTTP | Marketplace プラグインの Setup → Edit Values、または .cursor/mcp.json |
| VS Code Copilot | HTTP | .vscode/mcp.json → type: "http"、同じ URL |
| Claude Code / Codex / Gemini CLI | HTTP | --transport http を指定して CLI の mcp add を実行 |
| Claude Desktop | stdio | npx -y supergateway --streamableHttp <URL> --outputTransport stdio |
段階的な情報開示
タスクに該当する場合は、上記のドメインスキルを読み込んでください。product_api のパスが 404 を返す場合は、file://1inch-mcp/guides/api-index を取得するか、search を呼び出してください。