Come usare
- Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
- Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
- Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/1inch/1inch-ai --skill 1inch-mcp-serverPrima di iniziare
- L’installazione non include abbonamenti, quote API o accesso ai file.
- Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.
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.
