1inch 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

• Product documentation
• AI Skills
• Agent Skills specification
• Machine-readable API index

License

MIT