Metadata-Version: 2.4
Name: depthy-mcp
Version: 0.1.0
Summary: MCP server for Depthy — real-time crypto liquidity intelligence
Project-URL: Homepage, https://depthy.io
Project-URL: Documentation, https://depthy.io/api-docs
Project-URL: Repository, https://github.com/depthy-io/depthy-mcp
Author-email: Depthy <hello@depthy.io>
License-Expression: MIT
License-File: LICENSE
Keywords: crypto,hyperliquid,liquidity,mcp,order-book,polymarket
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.10
Requires-Dist: httpx>=0.24.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# Depthy MCP Server

MCP server that gives AI assistants access to real-time crypto market structure data from [Depthy](https://depthy.io) — order book depth, liquidity walls, liquidation clusters, and Polymarket signals.

## Quick Start

### Install

```bash
pip install depthy-mcp
```

### Get an API Key

Sign up for a free API key at [depthy.io](https://depthy.io).

### Claude Desktop Configuration

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

```json
{
  "mcpServers": {
    "depthy": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "env": {
        "DEPTHY_API_KEY": "dk_live_your_key_here"
      }
    }
  }
}
```

### Cursor Configuration

Add to `.cursor/mcp.json` in your project:

```json
{
  "mcpServers": {
    "depthy": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "env": {
        "DEPTHY_API_KEY": "dk_live_your_key_here"
      }
    }
  }
}
```

## Available Tools

| Tool | Description | Free Tier |
|---|---|---|
| `list_symbols` | List all tradable symbols | Yes |
| `get_depth` | Order book depth & bid/ask imbalance | Yes (T1) |
| `get_depth_recent` | Depth snapshots over last N minutes | Yes (T1) |
| `get_walls` | Large resting orders in the book | Yes (T1) |
| `get_liquidation_clusters` | Liquidation cascade risk zones | Yes (T1) |
| `get_market` | Price, volume, funding, open interest | Yes (T1) |
| `get_oi_change` | Open interest changes | Yes |
| `compare_symbols` | Multi-symbol comparison | Pro+ |
| `list_pm_markets` | Active Polymarket markets | Yes |
| `get_pm_signals` | Polymarket smart-money signals | Yes |
| `get_pm_top_wallets` | Top Polymarket wallets by profit | Yes |

## Example Queries

Once configured, ask your AI assistant:

- "What's the current order book depth for BTC?"
- "Are there any large walls near the current ETH price?"
- "Where are the liquidation clusters for SOL?"
- "Compare liquidity depth for BTC, ETH, and SOL"
- "What are the latest Polymarket signals?"

## Environment Variables

| Variable | Required | Default | Description |
|---|---|---|---|
| `DEPTHY_API_KEY` | Yes | — | Your Depthy API key |
| `DEPTHY_BASE_URL` | No | `https://depthy.io` | API base URL |

## Links

- [Depthy](https://depthy.io) — Platform & signup
- [API Documentation](https://depthy.io/api-docs) — Full endpoint reference
- [Python SDK](https://github.com/depthy-io/depthy-python) — For programmatic access

## License

MIT
