wallet-doctor 0.1.0

AI agent SDK for Solana blockchain forensics. Pay with SOL, no API keys needed.

Wallet Doctor MCP - Python SDK

AI agents pay for Solana blockchain data in SOL. No API keys. No accounts. Just send SOL and call.

pip install wallet-doctor

from wallet_doctor import WalletDoctor

wd = WalletDoctor()

# Check wallet safety before your agent interacts with a protocol
result = wd.token_safety(wallet="8xHUrNy3ZGwmqG5o2TGMrLDNTVjVwweUxDWLrL9SAD6")
print(result)

# Trace a suspicious transaction
result = wd.trace(tx="4Zk2...")
print(result)

# Get full portfolio audit
result = wd.portfolio_audit(wallet="...")
print(result)

Services and Pricing

Service	Price	Description
balance	0.001 SOL	Check wallet SOL and token balances
token_safety	0.005 SOL	Honeypot detection, rugpull analysis
approvals_audit	0.01 SOL	Find risky token approvals
drain_forensics	0.025 SOL	Analyze if wallet was drained
smart_money	0.01 SOL	Track whale wallet movements
portfolio_audit	0.025 SOL	Full wallet risk assessment

How Payment Works

1. Send SOL to 4dX3VmkGFJHj1XZbWN1MbRYnCaxYWEEN21LjkmCe9JRE
2. Call the API with ?tx=<your_transaction_hash>
3. API verifies payment on-chain, returns data

MCP Server URL

https://defi-webhook.m-zikriz.workers.dev

Add to any MCP-compatible agent:

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

Quick Start

from wallet_doctor import WalletDoctor

wd = WalletDoctor()
# Your agent checks wallet before any DeFi interaction
safety = wd.token_safety("INPUT_WALLET_ADDRESS")
if not safety["is_safe"]:
    print("WARNING: Unsafe wallet detected!")

Full docs: https://github.com/zikriz/wallet-doctor-mcp