wallet-doctor

Wallet Doctor — Solana Forensics for AI Agents

Give your AI agent wallet superpowers. Check balances, trace transactions, detect drain attacks, audit token safety, identify smart money — pay-per-call in SOL, no API keys, no accounts.

pip install wallet-doctor

Why Wallet Doctor?

• For AI agents — 13 services, all pay-per-call. Every check is one HTTP call.
• For Solana data — Real-time on-chain reads via Helius + DexScreener.
• For threat detection — Drain forensics, rug analysis, approvals audit, scam labels.
• For trading bots — Token safety, liquidity, smart money flow — all before you trade.
• Pricing — From 0.001 SOL (~$0.07) per call. No subscriptions.
• Payment — Just send SOL, return tx hash. No API keys, no signup.

from wallet_doctor import WalletDoctor

wd = WalletDoctor()

safety = wd.token_safety(wallet="8xHUrNy3ZGwmqG5o2TGMrLDNTVjVwweUxDWLrL9SAD6")
if not safety.get("is_safe"):
    print("Unsafe token detected, refusing to trade")

result = wd.txtrace(wallet="victim...", tx="4Zk2...")
result = wd.portfolio_audit(wallet="...")

All 13 Services

Service	Price (SOL)	Description
balance	0.001	SOL + SPL token balances
price_oracle	0.001	DEX price for any SPL token
token_safety	0.005	Honeypot, mint/freeze authority check
wallet_labels	0.005	Scam/honeypot protocol interactions
approvals	0.005	All active token approvals on a wallet
txtrace	0.005	Last 20 transaction signatures
nft_audit	0.005	NFT holdings with metadata
token_holders	0.010	Top 10 holders + % supply
smart_money	0.010	Whale/smart-money detection
liquidity_check	0.015	LP pool size + lock status
launch_analysis	0.020	New token launch (rug-risk)
drain_forensics	0.025	Full drain attack analysis
portfolio_audit	0.025	Complete wallet security audit

How Payment Works

Send SOL with any wallet, post the tx hash, get the data:

solana transfer --recipient 4dX3VmkGFJHj1XZbWN1MbRYnCaxYWEEN21LjkmCe9JRE 0.001 --allow-unfunded-recipient

curl 'https://defi-webhook.m-zikriz.workers.dev/api/agent?service=balance&wallet=<addr>&tx=<your_tx_hash>'

The worker verifies your payment on-chain instantly (sub-second).

Plug into any agent framework

{"mcpServers":{"wallet-doctor":{"url":"https://defi-webhook.m-zikriz.workers.dev"}}}

Compatible with: Claude Code, Cursor, Windsurf, ChatGPT Actions, Gemini, AWS AgentCore, CrewAI, LangChain, AutoGPT, n8n, MCP Inspector.

Quick Start (Python)

pip install wallet-doctor

from wallet_doctor import WalletDoctor
wd = WalletDoctor()
print(wd.balance(wallet="<addr>"))  # tx_hash required if SOL not pre-paid

Quick Start (CLI)

wallet-doctor balance --wallet <addr> --tx <tx_hash>
wallet-doctor token_safety --wallet <addr> --tx <tx_hash>

Quick Start (HTTP)

curl 'https://defi-webhook.m-zikriz.workers.dev/api/agent?service=balance&wallet=<addr>&tx=<tx_hash>'

Discovery Endpoints

Channel	URL
MCP Official Registry	https://registry.modelcontextprotocol.io/v0/servers/io.github.zikriz/wallet-doctor
PyPI	https://pypi.org/project/wallet-doctor/
NPM (MCP server)	https://www.npmjs.com/package/wallet-doctor-mcp
GitHub	https://github.com/zikriz/wallet-doctor-mcp
Agent Manifest	https://wallet-doctor-agents.pages.dev/agent.json

Compatibility

Solana mainnet · Helius RPC · Metaplex NFT · Jupiter / Raydium DEX · x402 protocol · MCP 2025-06-18

License

MIT — Wallet Doctor