About 1inch-mcp-server
A hub skill for connecting clients to the 1inch MCP server and selecting companion skills for specific 1inch domains. It documents available tools, authentication steps, and client setup options.
Key features
- 01Maps domain skills to tasks
- 02Lists server tools and access requirements
- 03Explains authentication flow
- 04Provides client connection setup guidance
- 05Describes wallet-based signing behavior
Use cases
- 01Configuring a client for the 1inch MCP server
- 02Choosing a skill for swaps or limit orders
- 03Looking up wallet and market data workflows
- 04Setting up WalletConnect signing
MCP support
Connects clients to the 1inch MCP server at the documented Streamable HTTP endpoint, with a stdio option for Claude Desktop. The server provides tools for swaps, orders, product APIs, documentation search, authentication, and optional WalletConnect, Aqua, and debugging functions.
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/1inch-mcp-serverin Claude Code to confirm it loaded.
Bundled filesreferences/AUTH.mdreferences/TOOLS.md
Details
From the project README1inch 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.