1inch MCP Server 是一个枢纽技能，用于把 1inch MCP 服务器接入到支持 MCP 的客户端中。资料同时提供了一组配套的领域技能，用于对应不同任务场景。
一、配套领域技能及加载时机
- 1inch-swap：经典兑换、Fusion 兑换、跨链兑换。
- 1inch-orderbook：限价订单。
- 1inch-wallet-data：通过 product_api 获取投资组合、余额、历史记录、NFT、代币元数据。
- 1inch-market-data：通过 product_api 获取现货价格、Gas 价格、图表。
- 1inch-infrastructure：通过 product_api 访问 Web3 RPC、交易网关、域名。
- 1inch-walletconnect：非托管钱包配对。
- 1inch-aqua：Aqua 策略分析。
- 1inch-debug：按组织范围查询请求日志。
当任务与上述场景匹配时，加载对应的领域技能。
二、服务器地址 生产环境服务器地址为：https://api.1inch.com/mcp/protocol（Streamable 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，使用 CLI 的 mcp add 命令并指定 --transport http。
- Claude Desktop：传输方式 stdio，使用 npx -y supergateway --streamableHttp <URL> --outputTransport stdio。
六、渐进式披露 当任务匹配时加载上述领域技能。若某个 product_api 路径返回 404，可获取 file://1inch-mcp/guides/api-index 或调用 search。