Supported Clients

The 1inch MCP Server and AI Skills work with a wide range of AI coding assistants. This page covers setup instructions, authentication configuration, and troubleshooting for each supported client.

Supported clients

The following clients are also MCP-compatible and can connect using the generic setup below:

• Continue — open-source AI assistant for VS Code and JetBrains
• Zed — AI-native code editor
• Amazon Q Developer — AWS AI coding assistant

MCP is an open standard with rapidly growing adoption. Any MCP-compatible client can connect to the 1inch MCP Server.

MCP Server setup

Claude Code

Claude Code supports HTTP MCP servers natively:

         
         

           Bash
         
 
         
         

           
           

             
1
2
3
4
5
           
 
           
           
claude mcp add \
  --transport http \
  --scope user \
  1inch-business \
  https://api.1inch.com/mcp/protocol
         
       

OpenAI Codex

Codex supports MCP servers in both the CLI and the VS Code extension:

         
         

           Bash
         
 
         
         

           
           

             
1
           
 
           
           
codex --mcp-server "https://api.1inch.com/mcp/protocol"
         
       

For the VS Code extension, add the server in the Codex MCP settings panel with the same URL.

Gemini CLI

Gemini CLI supports HTTP MCP servers natively:

         
         

           Bash
         
 
         
         

           
           

             
1
2
3
4
           
 
           
           
gemini mcp add \
  --transport http \
  1inch-business \
  https://api.1inch.com/mcp/protocol
         
       

Claude Desktop

Claude Desktop communicates via stdio, so you use supergateway to bridge to the HTTP server. This requires Node.js 18+.

Add the following to your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

         
         

           JSON
         
 
         
         

           
           

             
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
           
 
           
           
{
  "mcpServers": {
    "1inch-business": {
      "command": "/absolute/path/to/node/bin/npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://api.1inch.com/mcp/protocol",
        "--outputTransport",
        "stdio"
      ],
      "env": {
        "PATH": "/absolute/path/to/node/bin:/usr/bin:/bin"
      }
    }
  }
}
         
       

Replace /absolute/path/to/node/bin with the path to your Node.js installation (e.g., /usr/local/bin or the output of dirname $(which node)).

Cursor

Create or edit .cursor/mcp.json in your project root:

         
         

           JSON
         
 
         
         

           
           

             
1
2
3
4
5
6
7
           
 
           
           
{
  "mcpServers": {
    "1inch-business": {
      "url": "https://api.1inch.com/mcp/protocol"
    }
  }
}
         
       

Windsurf

Create or edit ~/.codeium/windsurf/mcp_config.json:

         
         

           JSON
         
 
         
         

           
           

             
1
2
3
4
5
6
7
           
 
           
           
{
  "mcpServers": {
    "1inch-business": {
      "serverUrl": "https://api.1inch.com/mcp/protocol"
    }
  }
}
         
       

VS Code (Copilot)

Create or edit .vscode/mcp.json in your project root:

         
         

           JSON
         
 
         
         

           
           

             
1
2
3
4
5
6
7
8
           
 
           
           
{
  "servers": {
    "1inch-business": {
      "type": "http",
      "url": "https://api.1inch.com/mcp/protocol"
    }
  }
}
         
       

JetBrains IDEs

IntelliJ IDEA, WebStorm, PyCharm, and other JetBrains IDEs support MCP through the AI Assistant (2025.1+).

1. Open Settings → Tools → AI Assistant → Model Context Protocol (MCP)
2. Click Add, select HTTP, and paste the following JSON snippet:

         
         

           JSON
         
 
         
         

           
           

             
1
2
3
4
5
6
7
           
 
           
           
{
  "mcpServers": {
    "1inch-business": {
      "url": "https://api.1inch.com/mcp/protocol"
    }
  }
}
         
       

The 1inch MCP tools will be available in the AI Assistant chat within your IDE.

Other MCP clients

Most MCP clients support HTTP transport and can connect directly to the server URL:

• Server URL: https://api.1inch.com/mcp/protocol

For clients that only support stdio transport, use supergateway to bridge to the HTTP server (requires Node.js 18+):

         
         

           Bash
         
 
         
         

           
           

             
1
2
3
           
 
           
           
npx -y supergateway \
  --streamableHttp https://api.1inch.com/mcp/protocol \
  --outputTransport stdio
         
       

Configure your client to launch this as a subprocess and communicate over stdin/stdout.

AI Skills installation

Install the 1inch AI Skill so your agent knows the server URL, tools, and auth patterns automatically:

         
         

           Bash
         
 
         
         

           
           

             
1
           
 
           
           
npx skills add 1inch/1inch-ai
         
       

No npm package required — distribution is git-based. For more details, see AI Skills.

For stdio-only clients (e.g. Claude Desktop), the skill documents the same URLs and auth patterns, but you still need the supergateway setup above for the actual MCP connection.

Authentication setup

The public tools (search, list_examples, get_example) work without authentication. To use the execution tools (swap, orderbook, product_api, debug), pass your API key via the Authorization header. Get a key from the 1inch Business Portal.

For the conceptual overview of API key vs OAuth authentication, see Authentication.

Claude Code:

         
         

           Bash
         
 
         
         

           
           

             
1
2
3
4
5
6
           
 
           
           
claude mcp add \
  --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --scope user \
  1inch-business \
  https://api.1inch.com/mcp/protocol
         
       

Cursor (.cursor/mcp.json):

         
         

           JSON
         
 
         
         

           
           

             
1
2
3
4
5
6
7
8
9
10
           
 
           
           
{
  "mcpServers": {
    "1inch-business": {
      "url": "https://api.1inch.com/mcp/protocol",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
         
       

VS Code Copilot (.vscode/mcp.json):

         
         

           JSON
         
 
         
         

           
           

             
1
2
3
4
5
6
7
8
9
10
11
           
 
           
           
{
  "servers": {
    "1inch-business": {
      "type": "http",
      "url": "https://api.1inch.com/mcp/protocol",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
         
       

Claude Desktop (supergateway):

         
         

           JSON
         
 
         
         

           
           

             
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
           
 
           
           
{
  "mcpServers": {
    "1inch-business": {
      "command": "/absolute/path/to/node/bin/npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://api.1inch.com/mcp/protocol",
        "--header",
        "Authorization: Bearer YOUR_API_KEY",
        "--outputTransport",
        "stdio"
      ],
      "env": {
        "PATH": "/absolute/path/to/node/bin:/usr/bin:/bin"
      }
    }
  }
}
         
       

For other clients, consult the client's MCP documentation for how to set custom HTTP headers on the transport.

Troubleshooting