Kinetic MCP — Opacus Docs

What is MCP?

Model Context Protocol (MCP) is an open standard that allows AI assistants to call external tools. Opacus's Kinetic MCP server acts as the bridge: it registers a set of tools with Claude or Cursor, and when the AI calls one, the MCP server translates it into an Agent Kernel HTTP request.

Installation

# Install the MCP config for Claude Desktop / Cursor
node packages/kinetic-mcp/bin/install.js \
  --api-key=YOUR_API_KEY \
  --api-url=http://127.0.0.1:3006

This writes the config to Claude Desktop's settings file. Restart Claude/Cursor after running.

Manual config (Claude Desktop)

If you prefer manual setup, add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "opacus-kinetic": {
      "command": "node",
      "args": ["/path/to/packages/kinetic-mcp/dist/index.js"],
      "env": {
        "OPACUS_API_KEY": "your-api-key",
        "OPACUS_API_URL": "http://127.0.0.1:3006"
      }
    }
  }
}

Available MCP tools

Agent management

Tool	Description	Example prompt
`launch_secure_task`	Launch an agent from a template with a USDC budget	"Launch an oracle agent with 0.5 USDC"
`estimate_task_cost`	Estimate USDC cost before launching	"How much will a bridge task cost?"
`get_balance`	Get current USDC balance for the authenticated user	"What's my Opacus balance?"

Payments (Citadel Mint)

Tool	Description	Example prompt
`pay_with_opacuspay`	Transfer USDC to any recipient	"Pay 1.2 USDC to merchant X via Opacus"
`pay_api_with_opacuspay`	Top up API credits for a specific provider	"Add 0.5 USDC to OpenAI via Opacus"
`pay_openai_api`	Shortcut: add OpenAI credits	"Add 0.1 USDC to my OpenAI balance"
`list_opacuspay_history`	Get payment transaction history	"Show my last 20 Opacus payments"
`withdraw_to_my_wallet`	Withdraw USDC from execution wallet	"Withdraw 5 USDC to 0x1234..."

Bridge & cross-chain

Tool	Description	Example prompt
`kineti_bridge_base_to_og`	Bridge USDC from Base to 0G network	"Bridge 1 USDC from Base to 0G"
`kineti_bridge_eth_to_og`	Bridge USDC from Ethereum/Arbitrum/Solana to 0G	"Bridge 0.9 USDC from Ethereum to 0G"

0G Storage

Tool	Description	Example prompt
`upload_0g_file`	Upload a file to 0G decentralized storage. Returns `rootHash`.	"Upload /data/report.pdf to 0G storage"
`download_0g_file`	Download a file from 0G storage by rootHash	"Download 0G file 0xabc123"
`verify_0g_merkle`	Verify file integrity via on-chain Merkle proof	"Verify 0G root hash 0xabc123 is intact"

0G Compute (AI inference)

Tool	Description	Example prompt
`stream_0g_chat`	Run AI chat inference on 0G decentralized GPUs	"Use 0G AI to analyze BTC market trends"
`generate_0g_image`	Generate an image via 0G Compute (Flux Turbo)	"Generate a futuristic city image using 0G AI"

Discovery & IoT

Tool	Description	Example prompt
`discover_agents`	Find agents by capability, location, or reputation score	"Find oracle agents near New York with reputation > 80"
`iot_micropayment`	Send a micropayment to an IoT device agent	"Pay 0.01 USDC to sensor device did:opacus:abc123"

Prompt examples (Claude)

# Launch a bridge task
"Bridge 1.5 USDC from Base to 0G network with Opacus"

# Check balance
"What's my current Opacus USDC balance?"

# Upload a file
"Upload the file at /tmp/mydata.csv to 0G decentralized storage"

# Pay OpenAI
"Add 0.2 USDC to my OpenAI credits via Opacus"

# Find agents
"Find Opacus bridge agents with reputation score above 85"

📝

The Kinetic MCP server connects to Agent Kernel on the URL and API key you provide during installation. If Agent Kernel restarts on a different port, re-run the install command.

← OpenClaw Gateway

Agentboard UI →