AsterDex

Provides real-time and historical market data tools via MCP for Claude Code, enabling price, candle, and order book queries.

python

0

GitHub Stars

python

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "solenyaresearch0000-asterdex-mcp": {
      "command": "python",
      "args": [
        "-m",
        "asterdex_mcp.server"
      ],
      "env": {
        "ASTERDEX_BASE_URL": "https://testnet-fapi.asterdex.com"
      }
    }
  }
}

You can run the AsterDex MCP Server to access real-time and historical market data tools from Claude Code. It provides a set of 9 data tools for common trading needs, enabling you to fetch order books, OHLCV candles, funding rates, pricing, and various price histories in a consistent MCP interface.

How to use

You interact with the MCP server through an MCP client integrated in Claude Code. Once the server is running, you can invoke the available data tools by describing the data you want, for example asking for an order book, candles, or price histories for a specific trading pair.

You don’t need to write protocol messages yourself. Just tell Claude Code the tool you want to use and include any required parameters like the trading pair and time window. For example, request the order book for a pair with your preferred depth, or ask for candles over a chosen interval and date range.

How to install

Prerequisites you need before installing the MCP server are Python 3.10 or higher and the Claude Code CLI.

Install the MCP Server by running these commands in order:

cd asterdex-mcp
pip install -e .

Configure Claude Code

Add the AsterDex MCP server to Claude Code so it can be used in conversations.

claude mcp add asterdex-mcp

Configure MCP settings manually

If you prefer to edit the MCP configuration file directly, add the server configuration to your MCP settings file.

{
  "mcpServers": {
    "asterdex": {
      "command": "python",
      "args": ["-m", "asterdex_mcp.server"]
    }
  }
}

Available tools

get_orderbook

Fetches order book depth including bids and asks for a trading pair.

get_klines

Returns OHLCV candlestick data for a trading pair and interval.

get_funding_rate_history

Retrieves historical funding rate data for a given symbol and time range.

get_ticker_24h

Provides 24-hour price change statistics for a trading pair.

get_mark_price

Returns mark price and related funding rate information.

get_ticker_price

Fetches the latest price for a trading pair.

get_book_ticker

Provides the best bid and ask prices from the order book.

get_index_price_klines

Gives index price candlestick history for a pair.

get_mark_price_klines

Gives mark price candlestick history for a pair.