Claude Code

EasyNode x402 gives Claude Code tools for browsing VPS and blockchain node products on EasyNode, purchasing with USDC on Base via x402 payments, managing instances, and decrypting credentials — all from your terminal.

Installation

Remote (Recommended)
Local

Connect to the hosted MCP server — no local install or Node.js needed:

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

Replace 0x... with your wallet private key.

Run the MCP server locally via npx (requires Node.js 20+):

Run npx @easynodexyz/mcp-x402 setup first to configure env variables

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

Or add manually to ~/.claude/settings.json:

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

Verifying the Connection

After adding the server, verify it’s connected:

claude mcp list

You should see easynode-x402 listed with its tools.

Using EasyNode x402

Once connected, you can ask Claude to use EasyNode tools directly:

> List available VPS products

> Purchase a 1-month VPS-S1 plan

> Show me my active instances

> What are the connection details for instance abc123?

> Renew my VPS instance for 3 months

The EasyNode x402 Plugin

MCP Server

7 tools for VPS and blockchain node management via x402 payments

Installing the Plugin

If you prefer using the Claude Code plugin system instead of claude mcp add:

/plugin marketplace add easynodexyz/mcp-x402
/plugin install easynode-x402-plugin@easynode-marketplace

Configuration

Variable	Required	Default	Description
`EASYNODE_PRIVATE_KEY`	Yes	—	Wallet private key (`0x...`)
`EASYNODE_MAX_PAYMENT`	No	`100`	Max USDC per transaction

Run npx @easynodexyz/mcp-x402 setup to store your key in ~/.easy-node/.env instead of setting system environment variables. Environment variables override values in ~/.easy-node/.env.

Available Tools

Tool	Description
`list_products`	Browse available VPS and blockchain node products
`create_order`	Purchase a product with USDC via x402 payment
`get_order`	Check order status and delivery progress
`list_instances`	List all active instances
`get_instance`	View instance details and credentials
`renew_instance`	Renew an existing instance subscription
`update_custom_name`	Rename an instance

Getting Started

Clients

MCP Tools

Guides

Resources

Installation

Verifying the Connection

Using EasyNode x402

The EasyNode x402 Plugin

MCP Server

Installing the Plugin

Configuration

Available Tools

Getting Started

Clients

MCP Tools

Guides

Resources

​Installation

​Verifying the Connection

​Using EasyNode x402

​The EasyNode x402 Plugin

MCP Server

​Installing the Plugin

​Configuration

​Available Tools

Installation

Verifying the Connection

Using EasyNode x402

The EasyNode x402 Plugin

Installing the Plugin

Configuration

Available Tools