Depthy MCP Server
MCP server that gives AI assistants access to real-time crypto market structure data from Depthy — order book depth, liquidity walls, liquidation clusters, and Polymarket signals.
Quick Start
Install
pip install depthy-mcp
Get an API Key
Sign up for a free API key at depthy.io.
Claude Desktop Configuration
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"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:
{
"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 — Platform & signup
- API Documentation — Full endpoint reference
- Python SDK — For programmatic access
License
MIT
Metadata
Release files for depthy-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| depthy_mcp-0.1.0.tar.gz | 4.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| depthy_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 7.4 kB
Release files / depthy_mcp-0.1.0.tar.gz
| Download URL | depthy_mcp-0.1.0.tar.gz |
|---|---|
| Size | 4.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9018d87ef90bd8176721dfe653ff725b77f2190105414cb7538a3f8e95f96a27
|
|
BLAKE2b-256 checksum How to use checksums |
016a8b805c11019bcfa2c99c29547bcfb51a2b41d284c1053a0f68e0d38590ad
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / depthy_mcp-0.1.0-py3-none-any.whl
| Download URL | depthy_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 3.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
21d1b9b12aec0e8d724c19aa4ef6ef043da30b706f11c50c17df77d3b9920d6c
|
|
BLAKE2b-256 checksum How to use checksums |
c47b3cbd76bbd2cb495a11a4e908bfb9cb2e30cdea26b3cd2e9fdc07fbfdf19b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|