Skip to main content

​
Installation

There are two ways to use the Easy Node MCP server:
  • Remote Server — Connect to https://mcp-x402.easy-node.xyz/mcp with a header. No install needed.
  • Local Server — Run npx @easynodexyz/mcp-x402 on your machine.

​
Remote Server

Point your MCP client at the hosted server and pass your private key via header:
  • URL: https://mcp-x402.easy-node.xyz/mcp
  • Header: X-Easynode-Private-Key: 0x...
No installation, no Node.js required. See client setup pages for per-client config.
Your private key is sent via HTTPS header — encrypted in transit, never in URL or logs. The server is stateless: the key is used per-request for EIP-3009 signing and is never stored. Always use a dedicated wallet with limited USDC.

​
Local Server

npx @easynodexyz/mcp-x402 setup
This wizard will:
  1. Prompt for your wallet private key
  2. Save configuration to ~/.easy-node/.env
  3. Output the IDE config to copy

​
Manual Setup

Create ~/.easy-node/.env: 
EASYNODE_PRIVATE_KEY=0x...
EASYNODE_API_URL=https://api.easy-node.xyz
EASYNODE_MAX_PAYMENT=1000
Then add the server to your IDE — see client setup pages for per-client instructions.

​
Next Steps