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:

```json
// 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.

```json
// 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](https://coinbase.com)
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

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

### 3. Add to Claude Code

```bash
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`:

```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](https://x402.org) — the open HTTP standard for AI agent micropayments, built by Coinbase.

## License

MIT