CryptoExchanges.Net.Mcp
0.6.0-preview.3
dotnet tool install --global CryptoExchanges.Net.Mcp --version 0.6.0-preview.3
dotnet new tool-manifest
dotnet tool install --local CryptoExchanges.Net.Mcp --version 0.6.0-preview.3
#tool dotnet:?package=CryptoExchanges.Net.Mcp&version=0.6.0-preview.3&prerelease
nuke :add-package CryptoExchanges.Net.Mcp --version 0.6.0-preview.3
CryptoExchanges.Net.Mcp
A read-only Model Context Protocol (MCP) stdio server that exposes crypto exchange data to LLM agents via 12 structured tools across Binance, Bybit, OKX, and Bitget — all returning the same canonical models regardless of exchange.
Read-only — no order placement. This server exposes market-data and account-read operations only. No write or trading tools exist.
Install
dotnet tool install -g CryptoExchanges.Net.Mcp
Requires .NET 10 SDK.
MCP Client Configuration
Add to your MCP client config (e.g. Claude Desktop claude_desktop_config.json):
{
"mcpServers": {
"crypto": {
"command": "crypto-mcp",
"env": {
"BINANCE_API_KEY": "...",
"BINANCE_SECRET_KEY": "...",
"BYBIT_API_KEY": "...",
"BYBIT_SECRET_KEY": "...",
"OKX_API_KEY": "...",
"OKX_SECRET_KEY": "...",
"OKX_PASSPHRASE": "...",
"BITGET_API_KEY": "...",
"BITGET_SECRET_KEY": "...",
"BITGET_PASSPHRASE": "..."
}
}
}
}
Environment Variables
| Variable | Required for | Description |
|---|---|---|
BINANCE_API_KEY |
Account tools | Binance API key (read permission) |
BINANCE_SECRET_KEY |
Account tools | Binance secret key |
BYBIT_API_KEY |
Account tools | Bybit API key (read permission) |
BYBIT_SECRET_KEY |
Account tools | Bybit secret key |
OKX_API_KEY |
Account tools | OKX API key (read permission) |
OKX_SECRET_KEY |
Account tools | OKX secret key |
OKX_PASSPHRASE |
Account tools | OKX API passphrase |
BITGET_API_KEY |
Account tools | Bitget API key (read permission) |
BITGET_SECRET_KEY |
Account tools | Bitget secret key |
BITGET_PASSPHRASE |
Account tools | Bitget API passphrase |
Market-data tools require no credentials — they use public endpoints only.
Tools (12 total)
Market Data (6) — no credentials required
| Tool | Description |
|---|---|
GetPrice |
Latest price for a trading pair on an exchange |
GetTicker |
24h ticker statistics for one pair, or all pairs if symbol omitted |
GetOrderBook |
Order book (bids/asks) for a pair, to the given depth |
GetKlines |
Candlestick/kline data for a pair at an interval |
GetRecentTrades |
Recent public trades for a pair |
GetExchangeInfo |
Exchange trading rules and the list of supported symbols |
Account (6) — read-scoped API credentials required
| Tool | Description |
|---|---|
GetBalances |
All non-zero asset balances for the account |
GetBalance |
Balance of a single asset (e.g. BTC) |
GetOpenOrders |
Open orders, optionally filtered by pair |
GetOrder |
A specific order by its exchange order id |
GetOrderHistory |
Historical orders for a pair |
GetTradeHistory |
The account's own executed trades for a pair |
Supported Exchanges
Pass exchange as one of: binance, bybit, okx, bitget (case-insensitive).
Symbol Format
All tools accept symbols as BASE/QUOTE, e.g. BTC/USDT, ETH/USDT.
Error Handling
Every tool returns a structured result envelope. On failure the error.category field is one of:
| Category | Meaning |
|---|---|
AuthRequired |
Missing or invalid API credentials |
RateLimited |
Exchange rate limit hit |
ExchangeUnavailable |
Exchange name not recognised |
Connectivity |
Network / exchange reachability issue |
SymbolNotSupported |
Unrecognised symbol format |
BadInterval |
Unrecognised kline interval string |
BadRequest |
Invalid argument (e.g. non-positive depth/limit, unknown asset) |
ExchangeError |
Exchange returned an API-level error |
Unknown |
Unexpected error |
License
Apache 2.0 — see LICENSE.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.6.0-preview.3 | 95 | 6/27/2026 |
| 0.6.0-preview.2 | 78 | 6/26/2026 |
| 0.6.0-preview.1 | 70 | 6/26/2026 |
| 0.5.0-preview.4 | 74 | 6/24/2026 |
| 0.5.0-preview.3 | 74 | 6/24/2026 |
| 0.5.0-preview.2 | 76 | 6/23/2026 |
| 0.5.0-preview.1 | 72 | 6/21/2026 |
| 0.4.0-preview.1 | 75 | 6/21/2026 |
| 0.3.0-preview.2 | 72 | 6/20/2026 |
| 0.3.0-preview.1 | 69 | 6/20/2026 |