Skip to main content

Wallet Doctor — Solana Forensics for AI Agents

PyPI MCP Registry Solana License Telegram

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)

Source distribution for wallet-doctor 0.2.3
File Size Uploaded
wallet_doctor-0.2.3.tar.gz 11.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for wallet-doctor 0.2.3
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

0.2.3 This release

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page