Skip to main content
Glama

dex-kline-mcp

MIT License
1

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

Tool: get_kline

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

Parameters
  • chain (str): Blockchain network (e.g., eth, bsc, solana)
  • address (str): Token contract address
  • timeframe (str): K-line timeframe (e.g., 1m, 5m, 15m, 1h, 4h, 12h, 1d). Default: 1h
  • end_time (str, optional): ISO 8601 timestamp for data end time (e.g., 2025-07-03T02:14:00Z). Default: current UTC time
  • limit (int): Number of data points to return (max 1000). Default: 100
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.

-
security - not tested
A
license - permissive license
-
quality - not tested

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

  1. Features
    1. Installation
      1. Prerequisites
      2. Setup
    2. Usage
      1. Tool: get_kline
    3. License
      1. Acknowledgments

        Related MCP Servers

        • A
          security
          A
          license
          A
          quality
          An MCP server implementation that enables access to DexScreener API data, providing real-time information on DEX pairs, token profiles, and market statistics across multiple blockchains.
          Last updated -
          7
          6
          JavaScript
          The Unlicense
        • -
          security
          A
          license
          -
          quality
          DexPaprika MCP server allows LLMs to access real-time and historical data on tokens, DEX trading activity, and liquidity across multiple blockchains. It enables natural language queries for exploring market trends, token performance, and DeFi analytics through a standardized interface.
          Last updated -
          102
          10
          JavaScript
          MIT License
          • Apple
        • -
          security
          -
          license
          -
          quality
          An MCP server that provides real-time access to Chainlink's decentralized on-chain price feeds, optimized for seamless integration into AI agents and autonomous systems.
          Last updated -
          JavaScript
          MIT License
        • -
          security
          A
          license
          -
          quality
          An MCP server that tracks and analyzes DEX liquidity pools to power intelligent DeFi agents and automated strategies.
          Last updated -
          Python
          MIT License

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/kukapay/dex-kline-mcp'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server