memecoin-radar-mcp

Instructions

Args:
    time_span (str): Time period for the query. Must be one of: '5h', '12h', '24h'.
        Defaults to '5h'.
    limit (int): Maximum number of tokens to return. Defaults to 100.

Returns:
    str: A formatted table of trending tokens on PumpSwap including mint address
        and trading volume, or an error message if the query fails.

Raises:
    ValueError: If an invalid time_span value is provided.
    httpx.HTTPStatusError: If the Dune API request fails.

Implementation Reference

• main.py:294-331 (handler)

  The main handler function for the 'get_trending_tokens_on_pumpswap' tool. It fetches trending tokens on PumpSwap by querying Dune Analytics based on time_span ('5h', '12h', '24h'), processes the data using helpers like get_latest_result and strip_a_tag, formats it into a table using tabulate, and returns the result as a string.

  @mcp.tool()
  def get_trending_tokens_on_pumpswap(time_span: str = "5h", limit: int = 100) -> str:
      """Retrieve tokens with the highest trading volume on PumpSwap within a specified time span.
  
      Args:
          time_span (str): Time period for the query. Must be one of: '5h', '12h', '24h'.
              Defaults to '5h'.
          limit (int): Maximum number of tokens to return. Defaults to 100.
  
      Returns:
          str: A formatted table of trending tokens on PumpSwap including mint address
              and trading volume, or an error message if the query fails.
  
      Raises:
          ValueError: If an invalid time_span value is provided.
          httpx.HTTPStatusError: If the Dune API request fails.
      """
      query_ids = {
          "5h": 4929624,
          "12h": 4929617,
          "24h": 4929607,
      }
      try:
          query_id = query_ids.get(time_span)
          if query_id is None:
              raise ValueError("Invalid time_span value. Allowed: 5h | 12h | 24h")
          data = get_latest_result(query_id, limit=limit)
          rows = [
              [
                  strip_a_tag(row["contract_address"]),
                  f'${row["volume_usd"]:.2f}'
              ]
              for row in data
          ]
          headers = ["Mint Address", "Trading Volume"]
          return f"# Top {limit} Trending Tokens on PumpSwap - Last {time_span}\n\n" + tabulate(rows, headers=headers)
      except Exception as e:
          return str(e)