memecoin-radar-mcp

Instructions

Args:
    limit (int): Maximum number of tokens to return. Defaults to 100.

Returns:
    str: A formatted table of Pump.fun graduates including volume rank, token name,
        mint address, trading volume, and graduation time, or an error message if the query fails.

Raises:
    httpx.HTTPStatusError: If the Dune API request fails.

Implementation Reference

• main.py:128-157 (handler)

  The main handler function for the tool, decorated with @mcp.tool(). Fetches data from Dune Analytics query 4832613, processes it using helper functions strip_a_tag and get_latest_result, formats a markdown table using tabulate, and returns the result as a string.

  @mcp.tool()
  def get_pumpfun_graduates_by_trading_volume(limit: int = 100) -> str:    
      """Retrieve Pump.fun token launches sorted by highest trading volume in the last 24 hours.
  
      Args:
          limit (int): Maximum number of tokens to return. Defaults to 100.
  
      Returns:
          str: A formatted table of Pump.fun graduates including volume rank, token name,
              mint address, trading volume, and graduation time, or an error message if the query fails.
  
      Raises:
          httpx.HTTPStatusError: If the Dune API request fails.
      """
      try:
          data = get_latest_result(4832613, limit=limit)
          rows = [
              [ 
                  row["volume_rank"], 
                  strip_a_tag(row["asset_with_chart"]), 
                  strip_a_tag(row["token_address_with_chart"]), 
                  f'${row["total_volume"]:.2f}', 
                  row["graduation_time"] 
              ]
              for row in data
          ]
          headers = ["Rank", "Token", "Mint Address", "Volume(12h)", "Graduation Time"]
          return f"# Top {limit} Pump.fun Graduates by Trading Volume - Last 24 Hours\n\n" + tabulate(rows, headers=headers)
      except Exception as e:
          return str(e)

• main.py:23-46 (helper)

  Helper function used by the tool to fetch the latest execution results from a specified Dune Analytics query ID via the Dune API.

  def get_latest_result(query_id: int, limit: int = 1000):
      """
      Fetch the latest results from a Dune Analytics query.
  
      Args:
          query_id (int): The ID of the Dune query to fetch results from.
          limit (int, optional): Maximum number of rows to return. Defaults to 1000.
  
      Returns:
          list: A list of dictionaries containing the query results, or an empty list if the request fails.
  
      Raises:
          httpx.HTTPStatusError: If the API request fails due to a client or server error.
      """
      url = f"{BASE_URL}/query/{query_id}/results"
      params = {"limit": limit}
      with httpx.Client() as client:
          response = client.get(url, params=params, headers=HEADERS, timeout=300)
          response.raise_for_status()
          data = response.json()
          
      result_data = data.get("result", {}).get("rows", [])
      return result_data

• main.py:47-49 (helper)

  Helper function used by the tool to extract plain text from HTML anchor tags (e.g., token names and addresses).

  def strip_a_tag(html):
      match = re.search(r'>(.*?)</a>', html)
      return match.group(1) if match else html

• main.py:128-128 (registration)

  The @mcp.tool() decorator registers the function as an MCP tool.

  @mcp.tool()

• main.py:129-141 (schema)

  Type hints and docstring defining the input schema (limit: int = 100) and output (str).

  def get_pumpfun_graduates_by_trading_volume(limit: int = 100) -> str:    
      """Retrieve Pump.fun token launches sorted by highest trading volume in the last 24 hours.
  
      Args:
          limit (int): Maximum number of tokens to return. Defaults to 100.
  
      Returns:
          str: A formatted table of Pump.fun graduates including volume rank, token name,
              mint address, trading volume, and graduation time, or an error message if the query fails.
  
      Raises:
          httpx.HTTPStatusError: If the Dune API request fails.
      """