exergynet-mcp-server

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