exergynet-mcp-server

The official MCP server for the ExergyNet physical-reality ZK proof infrastructure.

ExergyNet operates the LNES-04 protocol on Base L2 EVM and LNES-03 on Solana Mainnet. Android edge witnesses capture physical sensor data (GPS, camera, magnetometer, NFC, network density), desktop provers compress payloads to ZK-STARK receipts, and agents pay USDC for verified physical truth.

Quick Install

npx -y exergynet-mcp-server

Claude Code

claude mcp add --transport stdio \
  --env BASE_PRIVATE_KEY=your_hex_private_key \
  --env RPC_URL=your_base_rpc_url \
  exergynet -- npx -y exergynet-mcp-server

Claude Desktop / ElizaOS / Any MCP Client

{
  "mcpServers": {
    "exergynet": {
      "command": "npx",
      "args": ["-y", "exergynet-mcp-server"],
      "env": {
        "BASE_PRIVATE_KEY": "your_hex_private_key",
        "RPC_URL": "https://mainnet.base.org"
      }
    }
  }
}

Overview

ExergyNet is a sovereign DePIN compute clearinghouse. Physical sensor readings from Android edge witnesses are ZK-verified and settled on Base L2 via USDC escrow. Agents using this MCP server can autonomously open jobs, estimate routing economics, verify on-chain state, and retrieve proof receipts — without human intervention at any step.

Protocol contracts:

• LNES-04 Base Mainnet: 0x5CFE075149776f4b3cca07a27D4fd85A60BA5e3f
• LNES-03 Solana Mainnet: 7BCPpUMBxQMPomsgTaJsQdLEfycNwPWqkQD1Cea4CcCL

Configuration

| Variable | Required | Description | |---|---|---| | BASE_PRIVATE_KEY | ✅ Yes | Agent hot wallet private key (hex). Must hold Base Mainnet USDC. | | RPC_URL | ✅ Yes | Base L2 RPC endpoint. |

⚠️ Security: Use a dedicated agent wallet funded only for operations. Never reuse a primary wallet.

RPC options:

• Alchemy — https://base-mainnet.g.alchemy.com/v2/YOUR_KEY
• Infura — https://base-mainnet.infura.io/v3/YOUR_KEY
• Public (rate-limited) — https://mainnet.base.org

Tools

exergynet_open_job

Opens a compute job on the LNES-04 Base Mainnet membrane. Handles USDC approval and escrow atomically. Returns jobId and S3 metadata binding key.

{
  "opcode": "0x08",
  "metadata": { "vector": "NETWORK_DENSITY", "lat": 39.7776, "lon": -86.2944 }
}

Opcodes:

| Opcode | Vector | Description | |--------|--------|-------------| | 0x01 | OPTICAL | Camera / image capture | | 0x02 | GEOSPATIAL | GPS coordinate proof | | 0x03 | AMBIENT | Audio / environmental | | 0x04 | KINEMATIC | Accelerometer / motion | | 0x05 | NFC_RFID | Tag / badge scan | | 0x06 | MAGNETOMETER | EM field vector | | 0x07 | STORAGE_PING | Storage latency proof | | 0x08 | NETWORK_DENSITY | WiFi / BLE crowd density | | 0x09 | BIOMETRIC_GATE | Biometric verification | | 0x0A | ASYNC_COMPUTE | ML / inference task |

exergynet_estimate_gate

Calculate whether routing compute through ExergyNet is profitable versus an external provider.

{
  "externalComputeCostUsd": 0.05,
  "settlementCostUsd": 0.002,
  "riskMarginUsd": 0.001
}

Returns arbitrage analysis and routing recommendation.

exergynet_get_program_id

Returns canonical contract addresses for LNES-03 (Solana) and LNES-04 (Base).

No parameters required.

exergynet_verify_program

Checks whether the LNES-03 Solana program is live on Mainnet-Beta.

{ "rpcUrl": "https://api.mainnet-beta.solana.com" }

exergynet_get_proof_transaction

Returns the Genesis SettleExergy proof transaction signature — the first verified ZK-STARK receipt on ExergyNet.

No parameters required.

x402 Pay-Per-Call Sensor API

ExergyNet also exposes a protocol-compliant x402 pay-per-call API for direct sensor data access. AI agents using the @x402/client SDK can query live physical data without API keys.

Manifest: https://explorer-api.exergynet.org/x402

| Endpoint | Price | Data | |----------|-------|------| | GET /x402/sensor/network_density | $0.003 | Live BSSID/BLE density (crowd proxy) | | GET /x402/sensor/magnetometer | $0.003 | EM field vectors from edge witnesses | | GET /x402/proof/latest | $0.005 | Latest ZK-verified proof hash + metadata | | GET /x402/jobs/feed | $0.001 | Open job feed across all 10 sensor vectors |

Payment: USDC on Base Mainnet (eip155:8453) via PAYMENT-SIGNATURE header.
Facilitator: Coinbase CDP (https://api.cdp.coinbase.com/platform/v2/x402)

# Example: query manifest (free)
curl https://explorer-api.exergynet.org/x402

Compatible Agents

• Claude (Claude Code, Claude Desktop)
• ElizaOS (@elizaos/plugin-exergynet)
• AWS Bedrock AgentCore
• Any MCP-compatible agent runtime

Links

• 🌐 exergynet.org
• 📦 npm
• 🐙 GitHub
• 🗂️ MCP Registry — io.github.ezumba/exergynet
• ⚡ x402 Manifest
• 📊 L0 Explorer

License

MIT © ezumba