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

​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