About 1inch MCP
1inch MCP provides AI assistants and agents with documentation search and Web3 product tools for swaps, limit orders, wallet data, and market information. Companion Agent Skills describe domain-specific calls and workflows.
Key features
- 01Search documentation and retrieve SDK examples
- 02Run token and cross-chain swaps
- 03Create and manage limit orders
- 04Access wallet, market, and infrastructure APIs
- 05Query Aqua analytics and optional request logs
Use cases
- 01Find 1inch documentation or SDK examples
- 02Perform token swaps or cross-chain transactions
- 03Review wallet assets and market data
- 04Pair a wallet through WalletConnect
MCP support
The remote MCP server at `https://api.1inch.com/mcp/protocol` exposes documentation, trading, data, and other API tools to clients. Some public tools need no authentication; protected tools use an API key or OAuth.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.1inch.com/mcp/protocolclaude mcp add --transport http com-1inch-business https://api.1inch.com/mcp/protocol{"mcpServers":{"com-1inch-business":{"type":"http","url":"https://api.1inch.com/mcp/protocol"}}}Open in Cursor{"servers":{"com-1inch-business":{"type":"http","url":"https://api.1inch.com/mcp/protocol"}}}Open in VS Code{"mcpServers":{"com-1inch-business":{"type":"http","url":"https://api.1inch.com/mcp/protocol"}}}{"mcpServers":{"com-1inch-business":{"serverUrl":"https://api.1inch.com/mcp/protocol"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
10| Parameter | Type | Required | Description |
|---|---|---|---|
| page | number | No | Page number for pagination (default 1) |
| limit | number | No | Maximum results per collection (default 10) |
| query | string | Yes | Search query string |
| include_body | boolean | No | Include full document body in results (default true). Set to false for smaller responses. |
Details
From the project README1inch AI
Public distribution hub for 1inch AI integrations — Agent Skills, MCP server configs, and marketplace listings for Claude, Cursor, and other AI assistants.
MCP server
The 1inch MCP server is hosted at:
https://api.1inch.com/mcp/protocol
It provides tools for documentation search, SDK examples, token swaps, limit orders, authenticated product API access, WalletConnect, Aqua analytics, and (when enabled) org-scoped log lookup. Full documentation: 1inch MCP Server.
Quick setup
Cursor
Install 1inch MCP from the Cursor Marketplace. Skills load from this repo automatically. For authenticated tools without OAuth, open the plugin → Setup → Edit Values and paste an API key from the 1inch Business Portal. Leave the field empty to use public tools and OAuth.
Or create .cursor/mcp.json in your project:
{
"mcpServers": {
"1inch-mcp": {
"url": "https://api.1inch.com/mcp/protocol"
}
}
}
Claude Code
claude mcp add --transport http --scope user 1inch-mcp https://api.1inch.com/mcp/protocol
VS Code (Copilot)
Create .vscode/mcp.json in your project:
{
"servers": {
"1inch-mcp": {
"type": "http",
"url": "https://api.1inch.com/mcp/protocol"
}
}
}
Other clients
See the full setup guide for Claude Desktop, Windsurf, JetBrains, OpenAI Codex, Gemini CLI, ChatGPT, Grok, and more.
Agent Skills
Install the 1inch skills so your AI agent knows the server URL, auth patterns, and exact product_api call recipes:
npx skills add 1inch/1inch-ai
| Skill | Role |
|---|---|
1inch-mcp-server | Hub — MCP URL, auth, client setup, tool overview |
1inch-swap | Classic / Fusion / cross-chain via swap |
1inch-orderbook | Limit orders via orderbook |
1inch-wallet-data | Portfolio, balances, history, NFTs, tokens 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 WalletConnect pairing |
1inch-aqua | Aqua strategy analytics |
1inch-debug | Org-scoped request log lookup |
Skills load on demand (~30–50 tokens until invoked). Prefer a domain skill for concrete tasks — e.g. gas price → 1inch-market-data teaches GET /gas-price/v1.6/{chainId}.
See the Agent Skills specification.
Repository structure
.cursor-plugin/ Cursor Marketplace plugin (manifest, API-key setup values, MCP config)
.claude-plugin/ Claude Code plugin manifest
skills/ Agent Skills (agentskills.io)
1inch-mcp-server/ Hub skill (SKILL.md + AUTH/TOOLS references)
1inch-swap/ Swap workflows
1inch-orderbook/ Limit orders
1inch-wallet-data/ product_api recipes (Wallet & Data)
1inch-market-data/ product_api recipes (Market Data)
1inch-infrastructure/ product_api recipes (Infrastructure)
1inch-walletconnect/ WalletConnect
1inch-aqua/ Aqua analytics
1inch-debug/ Request log lookup
cursor/ Cursor plugin README and docs
claude/ Claude Connectors Directory pointer
assets/ Logo and branding
mcp.json MCP server configuration (remote URL)
server.json Official MCP Registry pointer
SECURITY.md Security policy and vulnerability reporting
Authentication
Public tools (search, list_examples, get_example, and read-only aqua when enabled) work without authentication. Authenticated tools (swap, orderbook, product_api, and optional debug) require an API key or OAuth login. See the MCP product docs.
Get an API key from the 1inch Business Portal.
Links
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.