> ## Documentation Index
> Fetch the complete documentation index at: https://x402.easy-node.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<Tabs>
  <Tab title="Remote (Recommended)" icon="cloud">
    Connect to the hosted MCP server — no local install or Node.js needed:

    ```bash theme={null}
    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.
  </Tab>

  <Tab title="Local" icon="computer">
    Run the MCP server locally via npx (requires Node.js 20+):

    <Tip>
      Run `npx @easynodexyz/mcp-x402 setup` first to configure env variables
    </Tip>

    ```bash theme={null}
    claude mcp add easynode-x402 -- npx -y @easynodexyz/mcp-x402
    ```

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

    ```json theme={null}
    {
      "mcpServers": {
        "easynode-x402": {
          "command": "npx",
          "args": ["-y", "@easynodexyz/mcp-x402"]
        }
      }
    }
    ```
  </Tab>
</Tabs>

### Verifying the Connection

After adding the server, verify it's connected:

```bash theme={null}
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

<CardGroup cols={1}>
  <Card title="MCP Server" icon="server" href="https://www.npmjs.com/package/@easynodexyz/mcp-x402">
    7 tools for VPS and blockchain node management via x402 payments
  </Card>
</CardGroup>

### Installing the Plugin

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

```bash theme={null}
/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                                |