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

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/doggybee/mcp-server-ccxt  
**GitHub Stars:** 144  
**npm Downloads (last month):** 30651  
**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:

- **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-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
- **get-funding-rates** — Get current funding rates
- **get-positions** — Get open positions information
- **get-open-orders** — Get all open orders
- **get-order-history** — Get order history
- **account-balance** — Get your account balance from a crypto exchange
- **place-market-order** — Place a market order on an exchange
- **place-limit-order** — Place a limit order on an exchange
- **cancel-order** — Cancel an existing order
- **cancel-all-orders** — Cancel all open orders
- **set-leverage** — Set leverage for futures
- **set-margin-mode** — Set margin mode for futures
- **place-futures-market-order** — Place futures market orders
- **place-futures-limit-order** — Place futures limit orders
- **transfer-funds** — Transfer funds between accounts (e.g., spot to futures)
- **cache-stats** — Get CCXT cache statistics
- **clear-cache** — Clear CCXT cache
- **set-log-level** — Set logging level
- **get-proxy-config** — Get proxy settings
- **set-proxy-config** — Configure proxy settings
- **set-market-type** — Set default market type
- **set-default-exchange** — Change the default exchange
- **system-info** — Get system and environment information

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

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

## 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. The README describes support for more than 20 exchanges and for spot, futures, and swap market types.

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`. The README shows global installation followed by the `mcp-server-ccxt` command, or direct execution with `npx`. 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. The README states that the software is informational, provides no investment advice, and comes without a warranty.

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