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.
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
| Param | Type | Required | Description |
|---|---|---|---|
toAddress | string | ✓ | Destination wallet address (0x…) |
amountUsdc | number | ✓ | Amount 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
| Param | Type | Required | Description |
|---|---|---|---|
templateId | string | ✓ | Agent template name (e.g. bridge, oracle, mev) |
budget | number | Desired 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
| Param | Type | Required | Description |
|---|---|---|---|
templateId | string | ✓ | Template: bridge, oracle, mev, data, monitor |
budget | number | ✓ | USDC budget for the task (min 0.001) |
params | object | Optional 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
| Param | Type | Required | Description |
|---|---|---|---|
intent | string | ✓ | Natural language description of the task |
maxCostUsdc | number | ✓ | Max USDC to spend on execution |
targetChain | string | 0g (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
| Param | Type | Required | Description |
|---|---|---|---|
intent | string | ✓ | What data you want |
maxCostUsdc | number | ✓ | Maximum 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
| Param | Type | Required | Description |
|---|---|---|---|
intent | string | ✓ | Task description or code to execute |
maxCostUsdc | number | ✓ | Max 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
| Param | Type | Required | Description |
|---|---|---|---|
intent | string | ✓ | Strategy description (e.g. "Find ETH/USDC arb") |
maxCostUsdc | number | ✓ | Max budget for the strategy |
targetChain | string | Chain 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
| Param | Type | Required | Description |
|---|---|---|---|
recipient | string | ✓ | Recipient wallet address or merchant ID |
amountUsdc | number | ✓ | Amount to pay in USDC |
note | string | Payment 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
| Param | Type | Required | Description |
|---|---|---|---|
provider | string | ✓ | openai, anthropic, gemini, xai, huggingface, perplexity |
prompt | string | ✓ | The prompt to send to the AI |
maxCostUsdc | number | Spending cap (default 0.01 USDC) | |
model | string | Specific 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"
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
| Param | Type | Required | Description |
|---|---|---|---|
amount | number | ✓ | USDC amount to bridge |
toAddress | string | Destination 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
| Param | Type | Required | Description |
|---|---|---|---|
filePath | string | ✓ | Local path or URL of the file to upload |
tags | string[] | 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
| Param | Type | Required | Description |
|---|---|---|---|
query | string | ✓ | Search query or capability description |
minReputation | number | Minimum Kinetic Score (0–100) | |
location | string | Geographic 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
| Param | Type | Required | Description |
|---|---|---|---|
query | string | ✓ | Product name, brand, or category |
country | string | 2-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
| Param | Type | Required | Description |
|---|---|---|---|
productId | string | ✓ | Bitrefill product slug (from search results) |
valueUsd | number | ✓ | Purchase value in USD |
email | string | Delivery 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"
Quick Reference
| Tool | Category | Min Cost | Auth |
|---|---|---|---|
get_balance | Wallet | Free | API Key |
withdraw_to_my_wallet | Wallet | Gas | API Key |
estimate_task_cost | Tasks | Free | API Key |
launch_secure_task | Tasks | 0.001 USDC | API Key + USDC |
execute_cross_chain_intent | Intents | 0.001 USDC | API Key + USDC |
buy_data_from_agent | Intents | 0.001 USDC | API Key + USDC |
run_remote_compute | Intents | 0.001 USDC | API Key + USDC |
execute_mev_strategy | Intents | 0.001 USDC | API Key + USDC |
pay_with_opacuspay | Payments | 0.001 USDC | API Key + USDC |
pay_api_usage | Payments | ~0.00001 USDC | API Key + USDC |
pay_api_with_opacuspay | Payments | 0.001 USDC | API Key + USDC |
pay_openai_api | Payments | 0.001 USDC | API Key + USDC |
list_opacuspay_history | Payments | Free | API Key |
kineti_bridge_base_to_og | Bridge | ~0.5 USDC | API Key + USDC |
kineti_bridge_eth_to_og | Bridge | ~0.5 USDC | API Key + USDC |
upload_0g_file | Storage | 0.001 USDC | API Key + USDC |
download_0g_file | Storage | Free | API Key |
verify_0g_merkle | Storage | Free | API Key |
stream_0g_chat | 0G AI | 0.001 USDC | API Key + USDC |
generate_0g_image | 0G AI | 0.01 USDC | API Key + USDC |
discover_agents | Discovery | Free | API Key |
iot_micropayment | IoT | 0.001 USDC | API Key + USDC |
search_bitrefill_products | Bitrefill | Free | API Key |
launch_bitrefill_purchase | Bitrefill | 1 USDC | API Key + USDC |
get_balance and deposit via the Agentboard → Balance pane.