MonteWalk

Instructions

Gets comprehensive market data for a cryptocurrency.

Args:
    coin_id: CoinGecko ID (e.g., 'bitcoin', 'ethereum')
    
Returns:
    Formatted string with market data

Implementation Reference

• tools/crypto_data.py:51-92 (handler)

  The core handler function for the 'get_crypto_market_data' tool. It takes a coin_id (e.g., 'bitcoin'), queries the CoinGecko API for detailed market data, and returns a formatted multi-line string with current price, market cap, volume, percentage changes (24h/7d/30d), and all-time high/low information.

  def get_crypto_market_data(coin_id: str) -> str:
      """
      Gets comprehensive market data for a cryptocurrency.
      
      Args:
          coin_id: CoinGecko ID (e.g., 'bitcoin', 'ethereum')
          
      Returns:
          Formatted string with market data
      """
      try:
          data = cg.get_coin_by_id(
              id=coin_id,
              localization=False,
              tickers=False,
              market_data=True,
              community_data=False,
              developer_data=False
          )
          
          market = data.get("market_data", {})
          
          return f"""
  Crypto Market Data: {data.get('name', coin_id).upper()}
  Symbol: {data.get('symbol', 'N/A').upper()}
  --------------------------------
  Current Price: ${market.get('current_price', {}).get('usd', 0):,.2f}
  Market Cap: ${market.get('market_cap', {}).get('usd', 0):,.0f}
  24h Volume: ${market.get('total_volume', {}).get('usd', 0):,.0f}
  --------------------------------
  24h Change: {market.get('price_change_percentage_24h', 0):.2f}%
  7d Change: {market.get('price_change_percentage_7d', 0):.2f}%
  30d Change: {market.get('price_change_percentage_30d', 0):.2f}%
  --------------------------------
  All-Time High: ${market.get('ath', {}).get('usd', 0):,.2f}
  ATH Date: {market.get('ath_date', {}).get('usd', 'N/A')[:10]}
  All-Time Low: ${market.get('atl', {}).get('usd', 0):,.2f}
  ATL Date: {market.get('atl_date', {}).get('usd', 'N/A')[:10]}
  """
      except Exception as e:
          logger.error(f"CoinGecko error for {coin_id}: {e}")
          return f"Error fetching market data for {coin_id}: {str(e)}"

• server.py:415-418 (registration)

  Registers the get_crypto_market_data tool (along with related crypto tools) as an MCP tool in the 'Cryptocurrency' category using the register_tools helper function.

  register_tools(
      [get_crypto_price, get_crypto_market_data, get_trending_crypto, search_crypto],
      "Cryptocurrency"
  )

• server.py:21-21 (registration)

  Import statement that brings the get_crypto_market_data function into the server.py module for registration as an MCP tool.

  from tools.crypto_data import get_crypto_price, get_crypto_market_data, get_trending_crypto, search_crypto

• tools/crypto_data.py:12-13 (helper)

  Global CoinGeckoAPI client initialization used by get_crypto_market_data and other crypto tools.

  # Initialize CoinGecko client
  cg = CoinGeckoAPI()