aiowhitebit-mcp

What is aiowhitebit-mcp?

aiowhitebit-mcp is a Message Control Protocol (MCP) server and client implementation for the WhiteBit cryptocurrency exchange API. Built on the aiowhitebit library and fastmcp, it provides both public endpoints and WebSocket-based real-time market data. It is intended for developers who want to connect AI agents or custom applications to WhiteBit’s market data.

How to use aiowhitebit-mcp?

Install via pip (pip install aiowhitebit-mcp), then run the server with the command-line interface: aiowhitebit-mcp --transport stdio (for Claude Desktop) or aiowhitebit-mcp --transport sse --host 127.0.0.1 --port 8000. Use the WhiteBitMCPClient class in Python to connect and call tools/resources.

Key features of aiowhitebit-mcp

• MCP server with public WhiteBit API endpoints
• Support for stdio, SSE, and WebSocket transports
• Easy-to-use Python client class
• Command-line interface for running the server
• Real-time market data via WebSocket streams
• Caching with disk persistence
• Rate limiting and circuit breaker patterns
• Integration with Claude Desktop via stdio transport

Use cases of aiowhitebit-mcp

• Building an AI assistant that queries live cryptocurrency market info
• Integrating WhiteBit order book and ticker data into a chat interface
• Subscribing to real-time best bid/ask prices with BookTicker WebSocket
• Fetching funding history for futures markets programmatically
• Deploying a local MCP server for custom multi-agent workflows

FAQ from aiowhitebit-mcp

What runtime does aiowhitebit-mcp require?

Python 3.9+ with the aiowhitebit and fastmcp libraries. Install with pip install aiowhitebit-mcp.

What transports are supported?

stdio, SSE, and WebSocket transports. Use --transport stdio for Claude Desktop or --transport sse for networked clients.

Can I use aiowhitebit-mcp with Claude Desktop?

Yes. Run aiowhitebit-mcp --transport stdio and point Claude Desktop to the server.

Does aiowhitebit-mcp cache data?

Yes. It includes caching with disk persistence to reduce repeated API calls.

What are the main WebSocket features?

Real-time last price, market depth, and BookTicker subscriptions for best bid/ask streams. WebSocket events optionally include metadata like event_time and update_id.