Metadata-Version: 2.4
Name: wallet-doctor
Version: 0.1.0
Summary: AI agent SDK for Solana blockchain forensics. Pay with SOL, no API keys needed.
Author-email: Wallet Doctor <wallet@wallet-doctor.netlify.app>
License: MIT
Project-URL: Homepage, https://github.com/zikriz/wallet-doctor-mcp
Project-URL: Documentation, https://defi-webhook.m-zikriz.workers.dev/api/services
Keywords: solana,blockchain,mcp,ai-agents,defi,wallet,security
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: mypy; extra == "dev"

# Wallet Doctor MCP - Python SDK

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

```bash
pip install wallet-doctor
```

```python
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:

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

## Quick Start

```python
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
