kukapay/alpha-ticker-mcp

Alpha Ticker MCP

An MCP server that streams real-time Binance Alpha token prices and liquidity data, powering your AI agents and workflows with instant alpha market insights.

Features

• Tools:
  • get_tokens: Retrieves a list of all tracked Binance Alpha tokens.
  • get_pools: Fetches a list of currently tracked liquidity pools.
  • get_price: Returns the latest price for a specified list of tokens (comma-separated symbols).
  • get_trades: Retrieves recent trade data for a specified token symbol.
  • get_kline: Fetches kline (candlestick) data for a token within a specified time period.
• Lightweight: Built for simplicity and compatibility with MCP clients.

Prerequisites

• Python: Version 3.10 or higher.
• uv: A Python package manager (recommended for dependency management).
• Kukapay Access Token: Required for accessing Kukapay Services. Obtain one from Kukapay.

Installation

1. Clone the Repository:

   git clone https://github.com/kukapay/alpha-ticker-mcp.git
   cd alpha-ticker-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 "Alpha Ticker"
   

   Configuration file as a reference:

   {
      "mcpServers": {
          "Alpha Ticker": {
              "command": "uv",
              "args": [ "--directory", "/path/to/alpha-ticker-mcp", "run", "main.py" ],
              "env": { "ACCESS_TOKEN": "kukapay_access_token"}               
          }
      }
   }
   

   Replace /path/to/alpha-ticker-mcp with your actual installation path, and kukapay_access_token with your access token obtained from Kukapay.

Usage

Alpha Ticker MCP provides five tools for fetching Binance Alpha token data.

get_tokens

Functionality: Retrieves a list of all supported Binance Alpha tokens from the backend API.

Parameters: None.

Example:

• Prompt: "List all supported Binance Alpha tokens."
• Response:

  ["B2", "AIOT", "ETH", "BTC", ...]
  

get_pools

Functionality: Fetches a list of currently tracked liquidity pools.

Parameters: None.

Example:

• Prompt: "Show me all tracked liquidity pools."
• Response:

  [{"symbol": "B2", "quote":"WBNB", "liquidity": 1000000}, {"symbol": "KOGE", "quote": "USDC", "liquidity": 500000}, ...]
  

get_price

Functionality: Returns the latest price for a specified list of tokens, provided as a comma-separated string of token symbols.

Parameters:

• symbols: str: Comma-separated list of token symbols (e.g., "B2,AIOT"). Required.

Example:

• Prompt: "What are the current prices for B2 and AIOT tokens?"
• Response:

  [["symbol": "B2", "price": 1.23}, {"symbol": "AIOT", "price": 4.56}, ...]
  

get_trades

Functionality: Retrieves recent trade data for a specified token symbol, with an optional limit on the number of trades returned.

Parameters:

• symbol: str: The token symbol (e.g., "B2"). Required.
• limit: int: Number of trades to return (1–1000, default: 500).

Example:

• Prompt: "Show me the last 100 trades for the B2 token."
• Response:

  [{"timestamp": 1697059200000, "symbol": "B2", "price": 1.23, "volume": 100}, ...]
  

get_kline

Functionality: Fetches kline (candlestick) data for a specified token within a given time period, with options for interval, time range, and data limit.

Parameters:

• symbol: str: The token symbol (e.g., "B2"). Required.
• interval: str: Kline interval (e.g., "5s", "15s", "30s", "1m", "3m", default: "1m").
• start_time: int | None: Start timestamp in milliseconds (optional).
• end_time: int | None: End timestamp in milliseconds (optional).
• limit: int: Number of kline data points (1–1000, default: 500).

Example:

• Prompt: "Get 1-minute kline data for B2 for the last hour."
• Response:

  [{"timestamp": 1697059200000, "open": 1.23, "high": 1.25, "low": 1.20, "close": 1.24, "volume": 1000}, ...]
  

License

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