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
Release files for wallet-doctor 0.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| wallet_doctor-0.2.3.tar.gz | 11.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| wallet_doctor-0.2.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 22.6 kB
Release files / wallet_doctor-0.2.3.tar.gz
| Download URL | wallet_doctor-0.2.3.tar.gz |
|---|---|
| Size | 11.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7c8104e0df80a02ee3ce255157aa7524cbaba6ac69c890a95c0f67ebffc7b48e
|
|
BLAKE2b-256 checksum How to use checksums |
573356da8e06c25ade5b6bae109978e682fdb007a8333cbd2a43edf9cb300846
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.0
|
Release files / wallet_doctor-0.2.3-py3-none-any.whl
| Download URL | wallet_doctor-0.2.3-py3-none-any.whl |
|---|---|
| Size | 11.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8c523b24a93aaea8b9253123634c997c7737df70499be8466c0d225c109ab5dd
|
|
BLAKE2b-256 checksum How to use checksums |
fcaa395457447a184a54c8423fd9779f990c14b611afad3ec06d47276dfa5fc0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.0
|