Dex Kline MCP

🚀 DEX K-line MCP

An MCP server that streams K-line (candlestick) data from decentralized exchanges (DEXs) to power your AI agents and workflows.

✨ Features

• K-line Data Retrieval: Fetches OHLCV (Open, High, Low, Close, Volume) data for specified tokens on supported chains (Ethereum, Binance Smart Chain, Solana).
• Dynamic Timeframes: Supports multiple timeframes (1m, 5m, 15m, 1h, 4h, 12h, 1d) with appropriate API endpoints.
• Best Pool Selection: Automatically selects the pool with the highest liquidity for accurate data.
• Flexible End Time: Allows specifying an end time in ISO 8601 format or defaults to the current UTC time.
• Tabular Output: Formats K-line data into a clean, readable table using the tabulate library.

📦 Installation

Prerequisites

• Python 3.10 or higher
• uv for dependency management

Setup

1. Clone the repository:

   git clone https://github.com/kukapay/dex-kline-mcp.git
   cd dex-kline-mcp
   

2. Install dependencies:

   uv sync
   

3. Installing to Claude Desktop: Install the server as a Claude Desktop application:

   uv run mcp install main.py --name "DEX K-line"
   

   Configuration file as a reference:

   {
      "mcpServers": {
          "DEX K-line": {
              "command": "uv",
              "args": [ "--directory", "/path/to/dex-kline-mcp", "run", "main.py" ]
          }
      }
   }
   

   Replace /path/to/dex-kline-mcp with your actual installation path.

💻 Usage Examples

Basic Usage

The server exposes a single tool, get_kline, which retrieves K-line data for a specified token.

Parameters

Example Prompt

Fetch the 1-hour K-line data for the token with the contract address 0xf4b385849f2e817e92bffbfb9aeb48f950ff4444 on the Binance Smart Chain (BSC).

Example Output

Pair: TOKEN/USDT

+---------------------+------------+------------+------------+------------+------------+
| Timestamp           | Open       | High       | Low        | Close      | Volume     |
+---------------------+------------+------------+------------+------------+------------+
| 2025-07-03 01:00:00 | 0.12345678 | 0.12345678 | 0.12345678 | 0.12345678 | 1234.56789 |
| 2025-07-03 00:00:00 | 0.12345678 | 0.12345678 | 0.12345678 | 0.12345678 | 1234.56789 |
+---------------------+------------+------------+------------+------------+------------+

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

👏 Acknowledgments

Data powered by GeckoTerminal API.