io.github.clearcheck-uk/voltix-mcp

Voltix MCP — 14 AI Agent Tools for Claude

14 production-ready tools accessible directly in Claude Code, Claude Desktop, and any MCP-compatible client. Each call makes a micropayment in USDC on Base — no API keys, no subscriptions, no accounts.

Tools

Tool	What it does	Cost
alpha_probe	Complete DeFi alpha report — whale flows + momentum tokens + best yields + market context in one call	$3.00
chainprobe	Deep on-chain intelligence for any Base address — token safety score OR wallet wealth tier, portfolio, risk flags	$0.50
whale_scan	Top whale wallets by USD inflow on Base — find smart money accumulation in real time	$0.50
web_search	Search the web, get structured results (titles, URLs, snippets)	$0.15
defi_yields	Best APY pools on Base from DeFiLlama — filter by min APY, TVL, stablecoin-only	$0.15
momentum_tokens	Trending Base tokens with momentum scores — trending rank + volume surge + price action	$0.25
liquidation_map	Lending pools at liquidation risk on Base — utilization rates across Aave, Compound, Moonwell	$0.25
parse_document	Extract structured JSON from any invoice, receipt, or contract image	$0.10
fetch_url	Extract clean readable text from any URL	$0.05
crypto_prices	Real-time prices, 24h change, volume for up to 25 coins	$0.05
gas_prices	Live gas prices on Ethereum, Base, Arbitrum, Optimism, Polygon	$0.05
ens_lookup	Resolve ENS names ↔ Ethereum addresses	$0.05
ai_query	AI inference via Gemini 2.5 Flash	$0.05
agent_memory	Persistent key-value memory across Claude sessions	$0.02

AlphaProbe — the flagship tool

alpha_probe is a single call that replaces 15+ individual API calls:

// No input required
{}
→ {
  "market_context": { "eth_usd": 3420, "btc_usd": 67000, "sentiment": "NEUTRAL" },
  "alpha_signals": [
    {
      "type": "TRENDING_BASE_TOKEN",
      "confidence": "HIGH",
      "token": { "symbol": "AERO", "name": "Aerodrome" },
      "evidence": ["Trending #2 on CoinGecko", "+18.4% in 24h", "$42M volume"],
      "action": "WATCH_FOR_PULLBACK",
      "risk": "HIGH"
    },
    {
      "type": "WHALE_ACCUMULATION",
      "confidence": "HIGH",
      "evidence": ["12 whale wallets received $50k+ in recent transfers", "Tokens moving: USDC, WETH"],
      "action": "MONITOR_WHALE_WALLETS"
    },
    {
      "type": "STABLE_YIELD_OPPORTUNITY",
      "protocol": "aave-v3",
      "evidence": ["8.4% APY on stablecoin", "$45M TVL", "On Base — low gas"],
      "action": "DEPOSIT_NOW"
    }
  ],
  "whale_activity": [...],
  "top_yields": [...]
}

ChainProbe — deep address intelligence

chainprobe auto-detects whether an address is a token or wallet:

Token input → safety score 0–100 covering: contract verification, token age, holder count, CoinGecko listing, Blockscout scam flag.

Wallet input → wealth tier (RETAIL / HOLDER / WHALE / MEGA_WHALE), activity type (HUMAN / BOT / INACTIVE), full token portfolio with USD values, total net worth estimate, and risk flags.

// Token example
{ "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" }
→ { "type": "token", "score": 95, "risk_level": "LOW", "verdict": "Token passes all major safety checks." }

// Wallet example
{ "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }
→ { "type": "wallet", "classification": { "whale_tier": "MEGA_WHALE", "activity_type": "HUMAN" }, "portfolio": { "estimated_total_usd": 340000 } }

Setup

1. Get USDC on Base

You need a small amount of USDC on the Base network to pay for tool calls. ~$5 covers hundreds of calls.

1. Buy USDC on Coinbase
2. Send to your wallet on Base network
3. Export your wallet's private key (Coinbase Wallet → Settings → Manage wallets → Export private key)

2. Install

git clone https://github.com/clearcheck-uk/voltix-mcp
cd voltix-mcp
npm install

3. Add to Claude Code

claude mcp add voltix-tools --scope user \
  -e PRIVATE_KEY=0xYOUR_PRIVATE_KEY \
  -- node /path/to/voltix-mcp/server.mjs

4. Add to Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "voltix-tools": {
      "command": "node",
      "args": ["/path/to/voltix-mcp/server.mjs"],
      "env": {
        "PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Usage in Claude

Once connected, just ask Claude naturally:

• "Use chainprobe to check if 0x1234... is safe to buy"
• "Search the web for latest Base chain news"
• "What's the current gas price on Ethereum?"
• "Look up what ENS name vitalik's address resolves to"
• "Remember this in agent_memory under namespace my-project: key='goal', value='build DeFi bot'"

Security

• Your private key never leaves your machine — it's only used locally to sign payment authorizations
• Each payment is a signed EIP-3009 TransferWithAuthorization — the signature authorizes a specific amount to a specific recipient at a specific time
• Payments are structural micropayments, not on-chain transactions — there is no gas cost

Powered by

Built on the x402 payment protocol — the open HTTP standard for AI agent micropayments, built by Coinbase.

License

MIT