Voltix MCP
A set of nine tools for AI agents with micropayments in USDC on Base, including on-chain intelligence, web search, document parsing, and more.
README
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.
- Buy USDC on Coinbase
- Send to your wallet on Base network
- 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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.
E2B
Using MCP to run code via e2b.