# 1inch MCP

Connects AI assistants to 1inch APIs for token swaps, limit orders, market metrics, and official documentation lookups.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Author: 1inch
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/1inch/1inch-ai
- Updated: 2026-09-13
- HTML: https://affpapa.org/en/nevibecode/mcp/1inch-mcp

## What it 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.

## Requirements
- Remote server: `https://api.1inch.com/mcp/protocol`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://api.1inch.com/mcp/protocol
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add 1inch-mcp --url https://api.1inch.com/mcp/protocol
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "1inch-mcp": {
            "url": "https://api.1inch.com/mcp/protocol"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "1inch-mcp": {
            "type": "http",
            "url": "https://api.1inch.com/mcp/protocol"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http 1inch-mcp https://api.1inch.com/mcp/protocol
```

## When to use it
- 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
- 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.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44591
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5469
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2197
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md