All MCP Clients - Easy Node x402 MCP

Amazon Q

Add this to your Amazon Q Developer CLI configuration file. See Amazon Q Developer CLI docs for more details.

Local Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Amp

Run this command in your terminal. See Amp MCP docs for more info.

amp mcp add --transport http --header "X-Easynode-Private-Key: 0x..." easynode-x402 https://mcp-x402.easy-node.xyz/mcp

Augment Code

To configure EasyNode x402 MCP in Augment Code, you can use either the graphical interface or manual configuration.

Using the Augment Code UI

Click the hamburger menu.
Select Settings.
Navigate to the Tools section.
Click the + Add MCP button.
Enter the following command:

npx -y @easynodexyz/mcp-x402@latest

Name the MCP: EasyNodeX402.
Click the Add button.

Manual Configuration

Press Cmd/Ctrl Shift P or go to the hamburger menu in the Augment panel
Select Edit Settings
Under Advanced, click Edit in settings.json
Add the server configuration to the mcpServers array in the augment.advanced object

"augment.advanced": {
  "mcpServers": [
    {
      "name": "easynode-x402",
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  ]
}

BoltAI

Open the “Settings” page, navigate to “Plugins,” and enter:

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

See BoltAI’s Documentation for more info.

Claude Code

Local Server Connection

claude mcp add easynode-x402 -- npx -y @easynodexyz/mcp-x402

Remote Server Connection

claude mcp add --transport http easynode-x402 https://mcp-x402.easy-node.xyz/mcp --header "X-Easynode-Private-Key: 0x..."

Claude Desktop

Local Server Connection

Open Claude Desktop developer settings and edit your config file (claude_desktop_config.json). See Claude Desktop MCP docs for more info.

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Remote Server Connection

Open Claude Desktop and navigate to Settings > Connectors > Add Custom Connector. Enter the name as EasyNodeX402 and the remote MCP server URL as https://mcp-x402.easy-node.xyz/mcp.

Crush

Add this to your Crush configuration file. See Crush MCP docs for more info.

Local Server Connection

{
  "$schema": "https://charm.land/crush.json",
  "mcp": {
    "easynode-x402": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Remote Server Connection

{
  "$schema": "https://charm.land/crush.json",
  "mcp": {
    "easynode-x402": {
      "type": "http",
      "url": "https://mcp-x402.easy-node.xyz/mcp",
      "headers": { "X-Easynode-Private-Key": "0x..." }
    }
  }
}

Cursor

Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP serverPasting the following configuration into your Cursor file (~/.cursor/mcp.json) is the recommended approach. You may also install in a specific project by creating .cursor/mcp.json in your project folder. See Cursor MCP docs for more info.

Local Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Remote Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "url": "https://mcp-x402.easy-node.xyz/mcp",
      "headers": { "X-Easynode-Private-Key": "0x..." }
    }
  }
}

Desktop Extension

Install the easynode-x402.mcpb file and add it to your client. See MCP bundles docs for more info.

Factory

Factory’s droid supports MCP servers through its CLI. See Factory MCP docs for more info.

Local Server Connection

droid mcp add easynode-x402 "npx -y @easynodexyz/mcp-x402"

Remote Server Connection

droid mcp add easynode-x402 https://mcp-x402.easy-node.xyz/mcp --type http --header "X-Easynode-Private-Key: 0x..."

Gemini CLI

See Gemini CLI Configuration for details.

Open the Gemini CLI settings file at ~/.gemini/settings.json
Add the following to the mcpServers object:

Local Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Remote Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "url": "https://mcp-x402.easy-node.xyz/mcp",
      "headers": {
        "X-Easynode-Private-Key": "0x...",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

GitHub Copilot CLI

Open ~/.copilot/mcp-config.json and add:

Local Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Remote Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "type": "http",
      "url": "https://mcp-x402.easy-node.xyz/mcp",
      "headers": { "X-Easynode-Private-Key": "0x..." }
    }
  }
}

GitHub Copilot Coding Agent

Add the following configuration to Repository->Settings->Copilot->Coding agent->MCP configuration:

{
  "mcpServers": {
    "easynode-x402": {
      "type": "http",
      "url": "https://mcp-x402.easy-node.xyz/mcp",
      "headers": { "X-Easynode-Private-Key": "0x..." }
    }
  }
}

See the official GitHub documentation for more info.

Google Antigravity

Add this to your Antigravity MCP config file. See Antigravity MCP docs for more info.

Local Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Remote Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "serverUrl": "https://mcp-x402.easy-node.xyz/mcp",
      "headers": {
        "X-Easynode-Private-Key": "0x..."
      }
    }
  }
}

JetBrains AI Assistant

See JetBrains AI Assistant Documentation for more details.

In JetBrains IDEs, go to Settings -> Tools -> AI Assistant -> Model Context Protocol (MCP)
Click + Add.
Click on Command in the top-left corner and select the As JSON option
Add this configuration:

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Click Apply to save changes.

Kilo Code

You can configure the EasyNode x402 MCP server in Kilo Code using either the UI or by editing your project’s MCP configuration file.Kilo Code supports two configuration levels:

Global MCP Configuration — stored in mcp_settings.json
Project-level MCP Configuration — stored in .kilocode/mcp.json (recommended)

Configure via Kilo Code UI

Open Kilo Code.
Click the Settings icon in the top-right corner.
Navigate to Settings → MCP Servers.
Click Add Server.
Choose HTTP Server (Streamable HTTP Transport).
Enter the details:

URL: https://mcp-x402.easy-node.xyz/mcp
Headers → Add Header
Key: X-Easynode-Private-Key
Value: 0x...

Click Save.

Manual Configuration

Create .kilocode/mcp.json:

{
  "mcpServers": {
    "easynode-x402": {
      "type": "streamable-http",
      "url": "https://mcp-x402.easy-node.xyz/mcp",
      "headers": {
        "X-Easynode-Private-Key": "0x..."
     },
     "alwaysAllow": [],
      "disabled": false
    }
  }
}

Kiro

See Kiro Model Context Protocol Documentation for details.

Navigate Kiro > MCP Servers
Add a new MCP server by clicking the + Add button.
Paste the configuration:

{
  "mcpServers": {
    "EasyNodeX402": {
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Click Save to apply.

LM Studio

See LM Studio MCP Support for more information.

Manual set-up:

Navigate to Program (right side) > Install > Edit mcp.json.
Paste the configuration:

{
  "mcpServers": {
    "EasyNodeX402": {
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Click Save.

</Accordion>
<Accordion title="OpenAI Codex">

See [OpenAI Codex](https://github.com/openai/codex) for more information.

#### Local Server Connection

```toml
[mcp_servers.easynode_x402]
args = ["-y", "@easynodexyz/mcp-x402"]
command = "npx"
startup_timeout_ms = 20_000

Remote Server Connection

[mcp_servers.easynode_x402]
url = "https://mcp-x402.easy-node.xyz/mcp"
http_headers = { "X-Easynode-Private-Key" = "0x..." }

If you see startup timeout errors, try increasing startup_timeout_ms to 40_000.

OpenCode

Add this to your Opencode configuration file (opencode.json). See Opencode MCP docs for more info.

Local Server Connection

{
  "mcp": {
    "easynode-x402": {
      "type": "local",
      "command": ["npx", "-y", "@easynodexyz/mcp-x402"],
      "enabled": true
    }
  }
}

Remote Server Connection

{
  "mcp": {
    "easynode-x402": {
      "type": "remote",
      "url": "https://mcp-x402.easy-node.xyz/mcp",
      "headers": { "X-Easynode-Private-Key": "0x..." },
      "enabled": true
    }
  }
}

Perplexity Desktop

See Local and Remote MCPs for Perplexity for more information.

Navigate Perplexity > Settings
Select Connectors.
Click Add Connector.
Select Advanced.
Enter Server Name: EasyNodeX402
Paste:

{
  "args": ["-y", "@easynodexyz/mcp-x402"],
  "command": "npx",
   "env": {}
}

Click Save.

Qodo Gen

See Qodo Gen docs for more details.

Open Qodo Gen chat panel in VSCode or IntelliJ.
Click Connect more tools.
Click + Add new MCP.
Add the configuration:

Local Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Remote Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "url": "https://mcp-x402.easy-node.xyz/mcp",
      "headers": { "X-Easynode-Private-Key": "0x..." }
    }
  }
}

Qwen Code

By default, configurations are saved to the project scope (.qwen/settings.json). Use the --scope user flag to save to the user scope (~/.qwen/settings.json) instead.

Remote Server Connection

qwen mcp add --transport http easynode-x402 https://mcp-x402.easy-node.xyz/mcp \
--header "X-Easynode-Private-Key: 0x..." \
--header "Accept: application/json, text/event-stream"

Local Server Connection

qwen mcp add easynode-x402 npx -y @easynodexyz/mcp-x402

Manual Configuration

Open the Qwen Code settings file at ~/.qwen/settings.json (user scope) or .qwen/settings.json (project scope)
Add the following to the mcpServers object:

Local Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Remote Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "url": "https://mcp-x402.easy-node.xyz/mcp",
      "headers": {
        "X-Easynode-Private-Key": "0x...",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

Roo Code

Add this to your Roo Code MCP configuration file. See Roo Code MCP docs for more info.

Local Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Remote Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "type": "streamable-http",
      "url": "https://mcp-x402.easy-node.xyz/mcp",
      "headers": { "X-Easynode-Private-Key": "0x..." }
    }
  }
}

Rovo Dev CLI

Edit your Rovo Dev CLI MCP config:

acli rovodev mcp

Local Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Remote Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "url": "https://mcp-x402.easy-node.xyz/mcp",
      "headers": { "X-Easynode-Private-Key": "0x..." }
    }
  }
}

Smithery

To install EasyNode x402 MCP Server for any client automatically via Smithery:

npx -y @smithery/cli@latest install @easynodexyz/mcp-x402 --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>

You can find your Smithery key in the Smithery.ai webpage.

Trae

Use the Add manually feature and fill in the JSON configuration. See Trae documentation for more details.

Local Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Remote Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "url": "https://mcp-x402.easy-node.xyz/mcp",
      "headers": { "X-Easynode-Private-Key": "0x..." }
    }
  }
}

Using Bun or Deno

Use these alternatives to run the local EasyNode x402 MCP server with other runtimes.

Bun

{
  "mcpServers": {
    "easynode-x402": {
      "command": "bunx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Deno

{
  "mcpServers": {
    "easynode-x402": {
      "command": "deno",
      "args": [
        "run",
        "--allow-env=NO_DEPRECATION,TRACE_DEPRECATION",
        "--allow-net",
        "npm:@easynodexyz/mcp-x402"
      ]
    }
  }
}

Using Docker

Create a Dockerfile:

FROM node:20-alpine
WORKDIR /app
RUN npm install -g @easynodexyz/mcp-x402
CMD ["mcp-x402"]

Build the image:

docker build -t easynode-x402-mcp .

Configure your MCP client:

{
  "mcpServers": {
    "easynode-x402": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "easynode-x402-mcp"],
      "transportType": "stdio"
    }
  }
}

Visual Studio 2022

See Visual Studio MCP Servers documentation for details.

Local Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Remote Server Connection

In Visual Studio MCP settings:

{
  "mcpServers": {
    "easynode-x402": {
      "type": "http",
      "url": "https://mcp-x402.easy-node.xyz/mcp",
      "headers": { "X-Easynode-Private-Key": "0x..." }
    }
  }
}

VS Code

Add this to your VS Code MCP config file (.vscode/mcp.json). See VS Code MCP docs for more info.

Local Server Connection

{
  "mcp": {
    "servers": {
      "easynode-x402": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@easynodexyz/mcp-x402"]
      }
    }
  }
}

Remote Server Connection

{
  "mcp" : {
    "servers": {
      "easynode-x402": {
        "type": "http",
        "url": "https://mcp-x402.easy-node.xyz/mcp",
        "headers": {"X-Easynode-Private-Key": "0x..."}
      }
    }
  }
}

Warp

See Warp Model Context Protocol Documentation for details.

Navigate Settings > AI > Manage MCP servers.
Add a new MCP server by clicking the + Add button.
Paste the configuration:

{
  "EasyNodeX402": {
    "command": "npx",
    "args": ["-y", "@easynodexyz/mcp-x402"],
    "env": {},
    "working_directory": null,
    "start_on_launch": true
  }
}

Click Save.

Windows

The configuration on Windows is slightly different. Use cmd to run npx:

{
  "mcpServers": {
    "easynode-x402": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@easynodexyz/mcp-x402"],
      "disabled": false,
     "autoApprove": []
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file (~/.codeium/windsurf/mcp_config.json). See Windsurf MCP docs for more info.

Local Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "command": "npx",
      "args": ["-y", "@easynodexyz/mcp-x402"]
    }
  }
}

Remote Server Connection

{
  "mcpServers": {
    "easynode-x402": {
      "serverUrl": "https://mcp-x402.easy-node.xyz/mcp",
      "headers": { "X-Easynode-Private-Key": "0x..." }
    }
  }
}

Zencoder

Go to the Zencoder menu (…)
Select Agent tools
Click on Add custom MCP
Add the name and configuration:

{
  "command": "npx",
  "args": ["-y", "@easynodexyz/mcp-x402"]
}

Click Install.

Getting Started

Clients

MCP Tools

Guides

Resources

​Local Server Connection

​Using the Augment Code UI

​Manual Configuration

​Local Server Connection

​Remote Server Connection

​Local Server Connection

​Remote Server Connection

​Local Server Connection

​Remote Server Connection

​Local Server Connection

​Remote Server Connection

​Local Server Connection

​Remote Server Connection

​Local Server Connection

​Remote Server Connection

​Local Server Connection

​Remote Server Connection

​Local Server Connection

​Remote Server Connection

​Configure via Kilo Code UI

​Manual Configuration

​Manual set-up:

​Remote Server Connection

​Local Server Connection

​Remote Server Connection

​Local Server Connection

​Remote Server Connection

​Remote Server Connection

​Local Server Connection

​Manual Configuration

​Local Server Connection

​Remote Server Connection

​Local Server Connection

​Remote Server Connection

​Local Server Connection

​Remote Server Connection

​Local Server Connection

​Remote Server Connection

​Bun

​Deno

​Local Server Connection

​Remote Server Connection

​Local Server Connection

​Remote Server Connection

​Local Server Connection

​Remote Server Connection

Local Server Connection

Using the Augment Code UI

Manual Configuration

Local Server Connection

Remote Server Connection

Local Server Connection

Remote Server Connection

Local Server Connection

Remote Server Connection

Local Server Connection

Remote Server Connection

Local Server Connection

Remote Server Connection

Local Server Connection

Remote Server Connection

Local Server Connection

Remote Server Connection

Local Server Connection

Remote Server Connection

Configure via Kilo Code UI

Manual Configuration

Manual set-up:

Remote Server Connection

Local Server Connection

Remote Server Connection

Local Server Connection

Remote Server Connection

Remote Server Connection

Local Server Connection

Manual Configuration

Local Server Connection

Remote Server Connection

Local Server Connection

Remote Server Connection

Local Server Connection

Remote Server Connection

Local Server Connection

Remote Server Connection

Bun

Deno

Local Server Connection

Remote Server Connection

Local Server Connection

Remote Server Connection

Local Server Connection

Remote Server Connection