opacus-kinetic-mcp

Connect Opacus Kinetic to Claude, Cursor, and any MCP-compatible AI agent with a single command.

Install

npx opacus-kinetic-mcp install --api-key=YOUR_API_KEY --api-url=https://opacus.xyz/api

Get your API key from opacus.xyz/agentboard → Settings → API Keys.

What it does

Writes the Opacus Kinetic MCP server config to all supported AI clients on your machine:

| Client | Config file | |---|---| | Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json | | Claude CLI | ~/.claude/config.json | | Cursor (global) | ~/.cursor/mcp.json | | Cursor (workspace) | .cursor/mcp.json | | Continue.dev | .continue/config.json |

Restart your AI client after running the command.

Available tools

Once connected, your AI agent can use:

| Tool | Description | |---|---| | get_balance | Get USDC balance and Kinetic score | | launch_secure_task | Launch a Kinetic agent task with budget | | estimate_task_cost | Estimate cost for a template | | list_templates | List available agent templates | | bridge_base_to_og | Bridge USDC from Base → 0G | | bridge_eth_to_og | Bridge ETH from Base → 0G | | bridge_to_0g_multichain | Bridge from Solana / Ethereum / Arbitrum → 0G | | swap_base_eth_to_usdc | Swap ETH → USDC on Base via Aerodrome | | swap_0g_to_usdc | Swap OG → USDC on 0G via Jaine DEX | | swap_usdc_to_0g | Swap USDC → OG on 0G via Jaine DEX | | withdraw_to_my_wallet | Withdraw USDC to your login wallet | | pay_with_opacuspay | Send an OpacusPay payment | | pay_api_with_opacuspay | Pay OpenAI / Anthropic / Google / xAI API with USDC | | list_opacuspay_history | List recent payments | | upload_0g_file | Upload file to 0G decentralized storage | | download_0g_file | Download file from 0G by root hash | | stream_0g_chat | Run AI inference on 0G Compute Network | | launch_0g_compute_task | Launch a 0G compute task with escrow | | launch_bitrefill_purchase | Buy gift cards or top-ups with USDC via Bitrefill |

ERC-7750 – Opacus Nitro (On-chain Agent Tasks)

| Tool | Description | |---|---| | kineti_nitro_submit_task | Submit a paid task to an on-chain AI agent. 1% fee to Opacus treasury | | kineti_nitro_complete_task | Complete a Nitro task and release payment to the agent |

ERC-7751 – H3 Routing (Geospatial Agent Network)

What is H3?

H3 is Uber's open-source hexagonal grid system. The planet is tiled into hierarchical hexagonal cells at 16 resolution levels — from continent-sized (res 0, ~4.4M km²) down to room-sized (res 15, ~1 m²). Opacus uses resolution 8 by default (~0.74 km² per cell, roughly a city neighbourhood).

Why hexagons?
  • Each cell has exactly 6 equidistant neighbours — no edge/corner asymmetry
  • A cell index (e.g. '88091dbdbffffff') encodes the full path from global → local
  • Agents in the same cell share the same H3 index → instant co-location lookups
  • Proximity search = compare H3 indices → no GPS coordinate exposure required

Citadel DID format (assigned at agent registration):

did:opacus:h3:{h3CellIndex}:{walletAddress}
                 └── encodes location           └── proves identity

Example: did:opacus:h3:88091dbdbffffff:0xDEAD…BEEF

H3 Tools

| Tool | Description | |---|---| | kineti_h3_register_agent | Register an agent on-chain with geospatial H3 index and capabilities | | kineti_h3_discover_agents | Discover agents by capability and minimum Kinetic Score | | kineti_citadel_register | Register in Citadel network with real GPS → auto-assigns H3 cell + DID | | kineti_h3_location_update | Update the stored GPS location of a registered Citadel agent | | kineti_h3_iot_publish | Publish IoT sensor data anchored to a GPS location (micro-escrow per reading) | | kineti_h3_task_route | Find nearest available agent within a radius and optionally launch a task |

H3 IoT DePIN Flow

GPS device → latLngToH3Cell() → register agent → publish readings → earn USDC

Each IoT publish call creates a micro-escrow. When the reading is verified, the escrow auto-releases. Use kineti_h3_iot_publish with amountUsdc: 0.001 for sub-cent micro-payments.

H3 Proximity Routing Flow

Task requester has GPS → kineti_h3_task_route(lat, lon, capability, radiusKm)
  → backend haversine-searches all registered agents
  → returns nearest match (or launches task automatically if taskPrompt provided)

ERC-7752 – 0G Bridge (Gasless Cross-Chain)

| Tool | Description | |---|---| | kineti_bridge_submit_intent | Submit a zero-gas cross-chain bridge intent. 1% fee to treasury |

ERC-7753 – Escrow V2 (Dispute-Arbitrated Payments)

| Tool | Description | |---|---| | kineti_escrow_create | Lock funds in two-party escrow with arbitrator | | kineti_escrow_release | Release escrow to payee with delivery proof |

ERC-7754 – Cross-Chain Mint

| Tool | Description | |---|---| | kineti_mint_initiate | Lock ERC-20 on source chain, mint wrapped token on destination |

ERC-7755 – Kinetic Score (On-chain Reputation)

| Tool | Description | |---|---| | kineti_score_register | Register agent on-chain with DID and pay registration fee | | kineti_score_get | Get on-chain Kinetic reputation score (0–10000) | | kineti_score_verify | Verify if agent meets minimum score threshold |

ERC-7756 – QUIC Transport Registry (HTTP/3 + eBPF)

On-chain directory of agent QUIC/HTTP3 endpoints. MEV bots and arbitrage agents declare their eBPF kernel-bypass capability and latency SLA (in µs) on-chain — any peer can discover the fastest reachable transport without a centralised directory.

Transport modes:

• Standard (0) — Regular QUIC/HTTP3
• KernelBypass (1) — eBPF + XDP zero-copy, 8–20 µs end-to-end
• Datagram (2) — WebTransport datagrams (browser / edge workers)

| Tool | Description | |---|---| | kineti_quic_register | Register your QUIC/HTTP3 endpoint on-chain with optional eBPF mode and µs latency SLA | | kineti_quic_discover | Discover agents by kernel-bypass flag or maximum latency budget | | kineti_quic_get_endpoint | Look up the on-chain QUIC endpoint for a specific agent wallet |

Example usage (Claude)

Payments & Balance

What's my Kinetic balance?

Send 10 USDC to 0x1234...abcd via OpacusPay

Pay my OpenAI API bill with USDC

Bridging & Cross-chain

Bridge 50 USDC from Base to 0G chain

Submit a cross-chain bridge intent for 100 USDC to chain 16600 using ERC-7752

Lock 200 BASE-USDC and mint wrapped OG-USDC on 0G for 0xRecipient...

On-chain Agent Tasks (ERC-7750 Nitro)

Submit a task to agent 0xABC... — summarise this PDF and pay 5 USDC on delivery

Check the status of Nitro task 0xTASKID...

Complete task 0xTASKID... with result hash 0xRESULTHASH...

H3 Agent Discovery & Geospatial Routing (ERC-7751)

Find on-chain agents with GPT4 capability and Kinetic Score above 8000

Register my agent at H3 index 8928308280fffff with QUIC endpoint quic://myagent.xyz:4433

List available agents with ImageGen capability in my region

Register my Citadel agent in Istanbul (lat 41.01, lon 28.97) — assign me an H3 DID

Update my agent's location to New York City

IoT Micropayments (H3 + DePIN)

Publish a temperature reading of 22.3°C from my sensor at lat 41.01, lon 28.97 — pay 0.001 USDC

Find the nearest data-bridge agent within 50km of Singapore and route this task to them

Escrow & Trustless Deals (ERC-7753)

Create an escrow: lock 300 USDC for freelancer 0xDEV..., arbitrator 0xARB...

Release escrow 0xESCROWID... — delivery proof hash is 0xPROOFHASH...

Reputation (ERC-7755 Kinetic Score)

What is the Kinetic Score of agent 0xAGENT...?

Does agent 0xAGENT... meet a minimum score of 8500?

Register my agent did:ethr:0xMYAGENT... on-chain with a 0.01 ETH reputation bond

Decentralised Storage & Inference

Upload ./report.pdf to 0G decentralised storage

Run AI inference on 0G Compute: "Summarise the latest Ethereum EIP drafts"

Swap 0.1 OG to USDC on Jaine DEX

Local development

node ./bin/install.js --api-key=YOUR_API_KEY --api-url=http://localhost:3006

Links

• opacus.xyz
• Agentboard
• npm