使用方法
- 复制安装命令，在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物，并对照来源检查输出。
npx skills add https://github.com/1inch/1inch-ai --skill 1inch-mcp-server开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。
按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。
1inch MCP Server
Hub skill for wiring the 1inch MCP server. Companion domain skills teach exact workflows:
| Skill | When to load |
|---|---|
1inch-swap | Classic / Fusion / cross-chain swaps |
1inch-orderbook | Limit orders |
1inch-wallet-data | Portfolio, balances, history, NFTs, token metadata via product_api |
1inch-market-data | Spot prices, gas price, charts via product_api |
1inch-infrastructure | Web3 RPC, tx gateway, domains via product_api |
1inch-walletconnect | Non-custodial wallet pairing |
1inch-aqua | Aqua strategy analytics |
1inch-debug | Org-scoped request log lookup |
Server URL (production)
https://api.1inch.com/mcp/protocol (Streamable HTTP)
Tools overview
| Tool | Auth | Purpose |
|---|---|---|
search | Public | Search 1inch docs and API reference |
list_examples / get_example | Public | SDK example packages |
authenticate | Authenticated | Start or confirm 1inch Business login |
swap | Authenticated | Quotes and swap execution |
orderbook | Authenticated | Build/create/list/cancel limit orders |
product_api | Authenticated | Call other 1inch product APIs |
walletconnect | Public (optional) | Pair/sign/send via WalletConnect |
aqua | Public reads (optional) | Aqua strategy analytics |
debug | Authenticated (optional) | Org-scoped request log lookup |
Full parameters: references/TOOLS.md. Auth: references/AUTH.md.
Initialize HTTP 200 is still anonymous. Call authenticate before paid tools; on HTTP 401 complete OAuth, then call authenticate again.
Signing flows: when the walletconnect tool is available, prefer connecting the user's wallet first — swap, orderbook, and aqua writes then execute through the connected wallet by default (execute defaults to true) and the user only approves prompts in their wallet app. See the 1inch-walletconnect skill.
Client setup (summary)
| Client | Transport | Config |
|---|---|---|
| Cursor | HTTP | Marketplace plugin Setup → Edit Values, or .cursor/mcp.json |
| VS Code Copilot | HTTP | .vscode/mcp.json → type: "http", same URL |
| Claude Code / Codex / Gemini CLI | HTTP | CLI mcp add with --transport http |
| Claude Desktop | stdio | npx -y supergateway --streamableHttp <URL> --outputTransport stdio |
Progressive disclosure
Load a domain skill above when the task matches. If a product_api path 404s, fetch file://1inch-mcp/guides/api-index or call search.
