1inch MCP — Claude Code MCP server: what it does, how to install
Connects AI assistants to 1inch APIs for token swaps, limit orders, market metrics, and official documentation lookups.
claude mcp add --transport http mcp https://api.1inch.com/mcp/protocolWhat 1inch MCP does
The server runs remotely at https://api.1inch.com/mcp/protocol. No local binary is needed. The toolset exposes trading routes, limit orders, gas prices, spot rates, and Aqua analytics directly to your coding assistant. It also fetches code samples and searches technical guides.
Authentication splits the toolset into two tiers. Public functions like searching documentation or pulling SDK examples work without credentials. Without an API key from the 1inch Business Portal or an OAuth login, requests to submit swaps, place orders, or fetch wallet balances fail.
You can also load domain skills from 1inch/1inch-ai. They instruct the model on specific endpoint paths while keeping token overhead low.
What it helps with
- quote and execute on-chain token swaps
- place limit orders through the orderbook tool
- check current gas prices and token spot rates
- inspect wallet balances and token holdings
Example prompts for the agent
- Look up current gas prices across networks using 1inch MCP.
- Search 1inch documentation for a cross-chain swap integration example.
- Check token balances and NFT assets for a target wallet address.
How to install 1inch MCP
Platform CLI: remote server
claude mcp add --transport http mcp https://api.1inch.com/mcp/protocolPlatform CLI: remote server
codex mcp add 1inch-mcp --url https://api.1inch.com/mcp/protocolConfig file
{
"mcpServers": {
"1inch-mcp": {
"url": "https://api.1inch.com/mcp/protocol"
}
}
}Config file
{
"servers": {
"1inch-mcp": {
"type": "http",
"url": "https://api.1inch.com/mcp/protocol"
}
}
}Platform CLI: remote server
gemini mcp add -t http 1inch-mcp https://api.1inch.com/mcp/protocolStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about 1inch MCP
How to install 1inch MCP in Claude Code?
Run claude mcp add --transport http 1inch-mcp https://api.1inch.com/mcp/protocol in your terminal. The assistant connects to the hosted HTTP endpoint immediately.
What does 1inch MCP do?
It brings 1inch decentralized finance capabilities into your editor. The model can search developer guides, check crypto market rates, and prepare swap transactions.
Do I need an API key to use 1inch MCP?
Documentation search and SDK example lookups require no credentials. You will need an API key from the 1inch Business Portal or an OAuth session for swaps, orderbook interactions, and portfolio queries.
