OpenCode

EasyNode x402 gives OpenCode 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.

For more details on MCP server configuration in OpenCode, see the OpenCode MCP documentation.

Installation

Remote (Recommended)
Local

No local dependencies required. Connects to EasyNode’s hosted MCP server.

Open your OpenCode config

Create or edit opencode.json in your project root, or ~/.config/opencode/opencode.json for global config. See the OpenCode config docs for more details.

# Global config
vim ~/.config/opencode/opencode.json

# Or project level config
vim opencode.json

Add EasyNode MCP server

Add the EasyNode x402 MCP server to the mcp section:

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

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

Runs on your machine. Requires Node.js 20+.

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

Open your OpenCode config

Create or edit opencode.json in your project root, or ~/.config/opencode/opencode.json for global config.

# Global config
vim ~/.config/opencode/opencode.json

# Or project level config
vim opencode.json

Add EasyNode MCP server

Add the EasyNode x402 MCP server to the mcp section:

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

Verifying the Connection

Restart OpenCode to load the MCP server.

Using EasyNode x402

Once connected, you can ask the agent 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

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

Configuration

Available Tools

​Installation

​Verifying the Connection

​Using EasyNode x402

​Configuration

​Available Tools

Installation

Verifying the Connection

Using EasyNode x402

Configuration

Available Tools