Docs / Core Services
Core Services

All MCP Tools

Complete reference for all 24 Kinetic MCP tools. Each tool is callable from Claude Desktop, Cursor, or any MCP-compatible AI client — or directly via JSON-RPC over HTTPS.

Endpoint: POST https://opacus.xyz/api/kinetic/mcp — JSON-RPC 2.0. For Claude Desktop, install via node packages/kinetic-mcp/bin/install.js --api-key=YOUR_KEY.

💰 Wallet & Balance

get_balance — Read current USDC balance

Returns your Sovereign Vault USDC balance across Base and 0G networks.

Parameters

None required.

Example Prompts

"What's my Opacus USDC balance?"
"How much USDC do I have in my Sovereign Vault?"
"Check my Opacus balance"

Response

{
  "balance": { "usdc": 10.5, "baseUsdc": 10.5, "ogUsdc": 0 },
  "executionWalletAddress": "0xABCD..."
}
withdraw_to_my_wallet — Withdraw USDC to external wallet

Sends USDC from your Opacus execution wallet to any Base-chain wallet address you own.

Parameters

ParamTypeRequiredDescription
toAddressstringDestination wallet address (0x…)
amountUsdcnumberAmount to withdraw in USDC

Example Prompts

"Withdraw 5 USDC to 0x1234...abcd"
"Send 2 USDC from my Opacus wallet to my MetaMask"
"Transfer 0.5 USDC out of Opacus to 0xABCD..."

🚀 Agent Tasks

estimate_task_cost — Estimate USDC cost before launching

Returns a cost estimate for a task template including execution fee, network fee, and Opacus platform fee — before committing any USDC.

Parameters

ParamTypeRequiredDescription
templateIdstringAgent template name (e.g. bridge, oracle, mev)
budgetnumberDesired budget in USDC (default 0.1)

Example Prompts

"How much will it cost to run a bridge agent with 0.5 USDC?"
"Estimate the cost of launching an oracle task on Opacus"
"What are the fees for running an MEV strategy?"
launch_secure_task — Launch an agent from a template

Deploys a Kinetic agent from a pre-built template. Locks USDC budget in escrow and starts the agent inside the Sovereign Vault infrastructure.

Parameters

ParamTypeRequiredDescription
templateIdstringTemplate: bridge, oracle, mev, data, monitor
budgetnumberUSDC budget for the task (min 0.001)
paramsobjectOptional template-specific parameters

Example Prompts

"Launch a bridge agent with 1 USDC budget"
"Start an oracle monitoring agent with 0.5 USDC"
"Deploy an MEV strategy agent with 2 USDC"
"Run a data collection agent on Opacus with 0.1 USDC"

Response

{
  "agentId": "agent_1234",
  "status": "running",
  "kineticScore": 0,
  "escrow": { "id": "escrow_abc", "amountUsdc": 1, "status": "locked" }
}

🌐 Cross-Chain Intents

execute_cross_chain_intent — Route a natural-language intent across chains

Routes a free-text agent intent to an Opacus Executor on the target chain via Opacus Nitro (Kinetic Streams). The intent is interpreted, executed, and proof of execution returned. USDC is deducted from your vault.

Parameters

ParamTypeRequiredDescription
intentstringNatural language description of the task
maxCostUsdcnumberMax USDC to spend on execution
targetChainstring0g (default), base, ethereum, solana

Example Prompts

"Execute an intent to get the current ETH/USDC price on 0G with max 0.001 USDC"
"Run a cross-chain intent: monitor whale wallets on Base with 0.005 USDC budget"
"Route an intent to Opacus: check BTC sentiment on Base, max cost 0.002 USDC"
"Execute intent on 0G network: find top DEX pools by volume, max 0.001 USDC"
"Run this on Ethereum: check Uniswap v3 ETH/USDC pool depth, max 0.003 USDC"

Response

{
  "status": "completed",
  "executionId": "exec_abc123",
  "executor": { "name": "Opacus Executor 0G", "endpoint": "quic://sg1.0g.compute:4433" },
  "proof": { "executionHash": "0x...", "verified": true },
  "cost": { "total": 0.00085, "opacusFee": 0.000005 }
}
buy_data_from_agent — Purchase data from an on-chain data agent

Pays a data-provider agent for structured data (price feeds, sentiment, on-chain metrics). Escrow is locked, data is delivered, payment is settled automatically.

Parameters

ParamTypeRequiredDescription
intentstringWhat data you want
maxCostUsdcnumberMaximum USDC you're willing to pay

Example Prompts

"Buy the latest BTC/USDC price from an oracle agent, max 0.001 USDC"
"Get ETH fear & greed index data from Opacus, spend up to 0.002 USDC"
"Purchase on-chain DeFi TVL data, max budget 0.005 USDC"
"Get top 10 whale wallet movements today from a data agent, max 0.003 USDC"
run_remote_compute — Run compute workload on a remote Opacus node

Submits a compute task to a remote Opacus executor node. Supports GPU and CPU workloads via Opacus Nitro.

Parameters

ParamTypeRequiredDescription
intentstringTask description or code to execute
maxCostUsdcnumberMax USDC budget

Example Prompts

"Run a compute task on Opacus: calculate moving average for ETH prices, max 0.005 USDC"
"Execute remote compute: sentiment analysis on 1000 tweets, budget 0.01 USDC"
"Run this Python analysis on an Opacus compute node, max cost 0.002 USDC"
execute_mev_strategy — Execute a MEV/arbitrage strategy

Routes a MEV (Maximal Extractable Value) or arbitrage strategy through the Opacus network. The strategy is routed to the appropriate executor and profit potential is estimated.

Parameters

ParamTypeRequiredDescription
intentstringStrategy description (e.g. "Find ETH/USDC arb")
maxCostUsdcnumberMax budget for the strategy
targetChainstringChain to run on (base, ethereum, 0g)

Example Prompts

"Find arbitrage opportunity between Uniswap and Aerodrome with 0.01 USDC"
"Execute MEV strategy: sandwich detection on Base, budget 0.1 USDC"
"Run arbitrage scanner on Ethereum mainnet with max 0.05 USDC"
"Look for backrun opportunities on Base DEXes, max cost 0.02 USDC"

💳 Payments (Citadel Mint)

pay_with_opacuspay — Send USDC to a recipient

Transfers USDC from your Opacus vault to another address or merchant via the Citadel Mint. Instant settlement, gas-free.

Parameters

ParamTypeRequiredDescription
recipientstringRecipient wallet address or merchant ID
amountUsdcnumberAmount to pay in USDC
notestringPayment memo / reason

Example Prompts

"Pay 1.5 USDC to merchant 0xABCD... via Opacus"
"Send 0.25 USDC to this address: 0x1234... for API services"
"Transfer 3 USDC to 0x5678... with note: 'agent data subscription'"
pay_api_usage — Pay for AI API usage (OpenAI / Anthropic / Gemini / xAI / HuggingFace / Perplexity)

Calls a supported AI provider API, deducts USDC from your vault, and returns the AI response. Supports 6 providers. Opacus holds the API keys — you pay only in USDC.

Parameters

ParamTypeRequiredDescription
providerstringopenai, anthropic, gemini, xai, huggingface, perplexity
promptstringThe prompt to send to the AI
maxCostUsdcnumberSpending cap (default 0.01 USDC)
modelstringSpecific model override (optional)

Example Prompts

"Use OpenAI GPT-4o via Opacus to summarize this text: ..."
"Call Anthropic Claude via Opacus: analyze this smart contract, max 0.02 USDC"
"Use Gemini to translate this to Turkish, pay from my Opacus vault, max 0.005 USDC"
"Ask Perplexity: what are today's top DeFi news? Cost from Opacus, max 0.01 USDC"
"Use xAI Grok via Opacus to explain this MEV transaction, max 0.02 USDC"
ℹ️
USDC is deducted from your Sovereign Vault on Base, then Opacus pays the AI provider using its API keys. You need USDC in your vault before calling this tool.
pay_api_with_opacuspay — Top-up API credits for a specific provider

Adds credits for a named API provider to your Opacus billing ledger, purchased with USDC.

Example Prompts

"Add 5 USDC of OpenAI credits via Opacus"
"Top up my Anthropic credits with 2 USDC via Opacus"
pay_openai_api — Shortcut: add OpenAI credits

Shorthand tool specifically for topping up OpenAI credits from your Opacus USDC balance.

Example Prompts

"Add 0.1 USDC to my OpenAI balance via Opacus"
"Top up OpenAI with 1 USDC from my Opacus"
list_opacuspay_history — View payment transaction history

Returns a list of all Citadel Mint transactions: payments sent, API credits, withdrawals, and deposits.

Example Prompts

"Show my last 20 Opacus payment transactions"
"What payments did I make through Opacus this week?"
"List my OpacusPay history"

🌉 Bridge

kineti_bridge_base_to_og — Bridge USDC from Base → 0G

Initiates a cross-chain USDC bridge from Base mainnet to the 0G network. Bridge confirmation is tracked automatically.

Parameters

ParamTypeRequiredDescription
amountnumberUSDC amount to bridge
toAddressstringDestination address on 0G (defaults to your vault)

Example Prompts

"Bridge 1 USDC from Base to 0G network"
"Move 2.5 USDC from Base mainnet to 0G using Opacus bridge"
"Bridge 0.5 USDC from Base to my 0G address 0x..."
kineti_bridge_eth_to_og — Bridge USDC from Ethereum/Arbitrum/Solana → 0G

Bridges USDC from non-Base sources (Ethereum L1, Arbitrum, Solana) to 0G. Routes via the appropriate relayer.

Example Prompts

"Bridge 0.9 USDC from Ethereum to 0G network"
"Transfer 1 USDC from Arbitrum to 0G via Opacus"
"Bridge USDC from Solana to 0G, amount 0.5"

🗄️ 0G Storage

upload_0g_file — Upload file to 0G decentralized storage

Stores a file on 0G's decentralized Data Availability layer. Returns a rootHash that can be used to retrieve or verify the file later.

Parameters

ParamTypeRequiredDescription
filePathstringLocal path or URL of the file to upload
tagsstring[]Optional metadata tags

Example Prompts

"Upload /data/report.pdf to 0G decentralized storage"
"Store this JSON file at /tmp/agent-output.json on 0G"
"Upload the trading log to 0G storage and give me the root hash"

Response

{ "rootHash": "0xabc123...", "size": 4096, "status": "stored" }
download_0g_file — Download file from 0G storage

Retrieves a file from 0G storage by its root hash.

Example Prompts

"Download 0G file with root hash 0xabc123..."
"Retrieve the file stored at 0G hash 0x789..."
"Get my file back from 0G storage, root hash 0xdef456"
verify_0g_merkle — Verify file integrity via Merkle proof

Verifies that a stored file has not been tampered with, using its on-chain Merkle proof from the 0G DA layer.

Example Prompts

"Verify the integrity of file with 0G root hash 0xabc123"
"Check if my 0G stored file is intact, hash 0x456..."
"Verify Merkle proof for 0G file 0x789..."

🤖 0G Compute (AI Inference)

stream_0g_chat — Run AI chat inference on 0G decentralized GPUs

Sends a prompt to 0G Compute Network's GPU cluster for inference. Supports various open-source models. Results are streamed back.

Example Prompts

"Use 0G AI to analyze recent BTC market trends"
"Run this prompt on 0G decentralized AI: summarize DeFi news"
"Stream a response from 0G compute: what is the risk of this smart contract?"
generate_0g_image — Generate an image via 0G Compute (Flux Turbo)

Generates an image using Flux Turbo running on 0G's decentralized GPU network. No centralized API — inference is distributed.

Example Prompts

"Generate a futuristic city image using 0G decentralized AI"
"Create an image of a sovereign AI agent on 0G Compute"
"Generate a logo for my DeFi protocol using 0G AI"

🔍 Discovery & IoT

discover_agents — Find agents by capability, location, or reputation

Searches the Opacus agent registry for agents matching your criteria. Uses Global Grid geospatial indexing for location-based queries.

Parameters

ParamTypeRequiredDescription
querystringSearch query or capability description
minReputationnumberMinimum Kinetic Score (0–100)
locationstringGeographic area (city or lat,lng)

Example Prompts

"Find oracle agents near Singapore with reputation above 80"
"Discover bridge agents with Kinetic Score over 90"
"Search for MEV agents near New York"
"List all data-provider agents with reputation > 75"
iot_micropayment — Send a micropayment to an IoT device agent

Sends a USDC micropayment to an IoT device identified by its Opacus DID. Used for machine-to-machine commerce on the Citadel network.

Example Prompts

"Pay 0.01 USDC to IoT sensor did:opacus:abc123"
"Send a micropayment to this device: did:opacus:h3:xxx:0xabc for its data"
"Pay 0.005 USDC to the weather station agent at did:opacus:..."

🎁 Bitrefill (Gift Cards & Top-ups)

search_bitrefill_products — Search Bitrefill product catalog

Searches the Bitrefill marketplace for gift cards, mobile top-ups, and utility payments. Returns matching products with available denominations.

Parameters

ParamTypeRequiredDescription
querystringProduct name, brand, or category
countrystring2-letter country code (e.g. US, TR)

Example Prompts

"Search Bitrefill for Netflix gift cards"
"Find Amazon gift cards on Bitrefill in the US"
"What Spotify cards are available on Bitrefill?"
"Search for mobile top-ups for Turkey on Bitrefill"
launch_bitrefill_purchase — Purchase a Bitrefill product with USDC

Purchases a Bitrefill gift card or top-up using USDC from your Opacus vault. Email delivery only — the redemption code is sent to your registered email.

Parameters

ParamTypeRequiredDescription
productIdstringBitrefill product slug (from search results)
valueUsdnumberPurchase value in USD
emailstringDelivery email (defaults to your account email)

Example Prompts

"Buy a $10 Netflix gift card from Bitrefill using my Opacus USDC"
"Purchase a $25 Amazon gift card with USDC via Bitrefill on Opacus"
"Buy 1 USDC minimum gift card on Bitrefill"
"Get a Spotify 3-month subscription via Bitrefill, pay with Opacus USDC"
ℹ️
Minimum purchase is 1 USDC. The redemption code is delivered to your email within minutes of purchase. You need USDC in your Sovereign Vault.

Quick Reference

ToolCategoryMin CostAuth
get_balanceWalletFreeAPI Key
withdraw_to_my_walletWalletGasAPI Key
estimate_task_costTasksFreeAPI Key
launch_secure_taskTasks0.001 USDCAPI Key + USDC
execute_cross_chain_intentIntents0.001 USDCAPI Key + USDC
buy_data_from_agentIntents0.001 USDCAPI Key + USDC
run_remote_computeIntents0.001 USDCAPI Key + USDC
execute_mev_strategyIntents0.001 USDCAPI Key + USDC
pay_with_opacuspayPayments0.001 USDCAPI Key + USDC
pay_api_usagePayments~0.00001 USDCAPI Key + USDC
pay_api_with_opacuspayPayments0.001 USDCAPI Key + USDC
pay_openai_apiPayments0.001 USDCAPI Key + USDC
list_opacuspay_historyPaymentsFreeAPI Key
kineti_bridge_base_to_ogBridge~0.5 USDCAPI Key + USDC
kineti_bridge_eth_to_ogBridge~0.5 USDCAPI Key + USDC
upload_0g_fileStorage0.001 USDCAPI Key + USDC
download_0g_fileStorageFreeAPI Key
verify_0g_merkleStorageFreeAPI Key
stream_0g_chat0G AI0.001 USDCAPI Key + USDC
generate_0g_image0G AI0.01 USDCAPI Key + USDC
discover_agentsDiscoveryFreeAPI Key
iot_micropaymentIoT0.001 USDCAPI Key + USDC
search_bitrefill_productsBitrefillFreeAPI Key
launch_bitrefill_purchaseBitrefill1 USDCAPI Key + USDC
💡
Pro tip: All tools that cost USDC require you to have a funded Sovereign Vault. Check your balance with get_balance and deposit via the Agentboard → Balance pane.
Previous
← Kinetic MCP