# doggybee/mcp-server-ccxt [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/doggybee/mcp-server-ccxt  
**GitHub Stars:** 145  
**npm Downloads (last month):** 734  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/doggybee-mcp-server-ccxt

## Description
An MCP server for accessing real-time crypto market data and trading via 20+ exchanges using the CCXT library. Supports spot, futures, OHLCV, balances, orders, and more.

## Tools
Capabilities this server exposes over MCP:

- **cache-stats** — Get CCXT cache statistics
- **clear-cache** — Clear CCXT cache
- **set-log-level** — Set logging level
- **list-exchanges** — List all available cryptocurrency exchanges
- **get-ticker** — Get current ticker information for a trading pair
- **batch-get-tickers** — Get ticker information for multiple trading pairs at once
- **get-orderbook** — Get market order book for a trading pair
- **get-ohlcv** — Get OHLCV candlestick data for a trading pair
- **get-trades** — Get recent trades for a trading pair
- **get-markets** — Get all available markets for an exchange
- **get-exchange-info** — Get exchange information and status
- **get-leverage-tiers** — Get futures leverage tiers for trading pairs
- **get-funding-rates** — Get current funding rates for perpetual contracts
- **get-market-types** — Get market types supported by an exchange
- **account-balance** — Get your account balance from a crypto exchange
- **place-market-order** — Place a market order on an exchange
- **set-leverage** — Set leverage for futures trading
- **set-margin-mode** — Set margin mode for futures trading
- **place-futures-market-order** — Place a futures market order
- **get-proxy-config** — Get the current proxy configuration
- **set-proxy-config** — Configure proxy settings for all exchanges
- **test-proxy-connection** — Test the proxy connection with a specified exchange
- **clear-exchange-cache** — Clear exchange instance cache to apply configuration changes
- **set-market-type** — Set default market type for all exchanges

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-server-ccxt": {
    "command": "npx",
    "args": ["-y","@mcpfun/mcp-server-ccxt"]
  }
}
```

## Documentation

## What doggybee/mcp-server-ccxt MCP server does

The doggybee/mcp-server-ccxt MCP server connects MCP-compatible clients to cryptocurrency exchanges through the CCXT library. It presents exchange operations as MCP tools instead of requiring an agent to implement each exchange API separately.

Public operations include listing exchanges, retrieving ticker and batch ticker data, reading OHLCV candles and recent trades, inspecting markets, checking exchange status, viewing funding rates, and retrieving futures leverage tiers. An order book tool is also documented in the project README. Private operations cover balances, open orders, order history, order cancellation, spot and futures order placement, leverage and margin configuration, and transfers between account types.

## How it works

An MCP client sends tool requests to the server. The server manages exchange instances and passes exchange operations through CCXT's unified API. Its internal modules separate exchange and credential handling from utility functions and MCP tool implementations.

The server includes caching and request-rate controls. The documented cache durations include 10 seconds for ticker data, 5 seconds for order book data, and one hour for market data. Rate handling can adapt to exchange responses, back off after errors, and manage concurrent requests for an exchange. Utility tools expose cache statistics, cache clearing, logging controls, proxy settings, default exchange selection, and default market type selection.

## Setup and configuration

The doggybee/mcp-server-ccxt MCP server can be installed from npm as `@mcpfun/mcp-server-ccxt`. It also documents cloning the repository, installing dependencies, building it, and starting it with npm.

Configuration is supplied through environment variables. `DEFAULT_EXCHANGE` and `DEFAULT_MARKET_TYPE` can select defaults. Exchange-specific credentials use variables such as `BINANCE_API_KEY`, `BINANCE_SECRET`, `KUCOIN_API_KEY`, `KUCOIN_SECRET`, and `KUCOIN_PASSPHRASE`. Proxy access can be enabled with `USE_PROXY` and configured with `PROXY_URL`. Credentials are optional for public market data, but private account and trading tools require appropriate exchange API permissions.

Claude Desktop can launch the globally installed server through a `mcpServers` entry whose command is `mcp-server-ccxt`. The project also documents a manual Node.js configuration that points to the built server file.

## Tools and capabilities

Available tool groups include:

- Market data: exchanges, tickers, batch tickers, order books, OHLCV, trades, and markets.
- Exchange and derivatives data: exchange status, leverage tiers, funding rates, positions, open orders, and order history.
- Private actions: balances, market and limit orders, futures orders, cancellations, leverage, margin mode, and fund transfers.
- Runtime controls: cache inspection and clearing, log level, proxy configuration, market type, default exchange, and system information.

## Limitations and notes

Exchange behavior and supported operations depend on the specific exchange and its CCXT implementation. Trading and account tools require API credentials with suitable permissions. The project recommends restricting permissions, avoiding withdrawal access when unnecessary, using IP allowlists where available, and keeping credentials out of source control.

Using the doggybee/mcp-server-ccxt MCP server to trade carries cryptocurrency and API-key security risks.

_Full upstream README: https://allmcps.com/mcp/doggybee-mcp-server-ccxt/readme_