> ## 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.

# Cursor

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

## Installation

<Tabs>
  <Tab title="Remote (Recommended)" icon="cloud">
    Add to your Cursor MCP settings (`.cursor/mcp.json`):

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

    Replace `0x...` with your wallet private key.
  </Tab>

  <Tab title="Local" icon="computer">
    <Tip>
      Run `npx @easynodexyz/mcp-x402 setup` first to configure env variables
    </Tip>

    `.cursor/mcp.json`:

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

### Config File Locations

| Scope | Path |
| - | - |
| Project | `.cursor/mcp.json` in project root |
| Global (macOS) | `~/.cursor/mcp.json` |
| Global (Windows) | `%USERPROFILE%\.cursor\mcp.json` |

### Verifying the Connection

Restart Cursor 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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.