REI Crypto MCP Server

Instructions

List all dexs along with summaries of their volumes and dataType history data filtering by chain.

Parameters:
    chain: chain name (e.g., 'ethereum')
    exclude_total_data_chart: true to exclude aggregated chart from response
    exclude_total_data_chart_breakdown: true to exclude broken down chart from response

Implementation Reference

• defillama_server.py:766-786 (handler)

  The main handler function decorated with @mcp.tool(), implementing the logic to fetch DEX overview data for a specific chain from the DefiLlama API using the make_request helper. Includes input parameters with type hints serving as schema and comprehensive docstring.

  @mcp.tool()
  async def get_dex_overview_by_chain(
      chain: str,
      exclude_total_data_chart: bool = True,
      exclude_total_data_chart_breakdown: bool = True
  ) -> str:
      """GET /api/overview/dexs/{chain}
      
      List all dexs along with summaries of their volumes and dataType history data filtering by chain.
      
      Parameters:
          chain: chain name (e.g., 'ethereum')
          exclude_total_data_chart: true to exclude aggregated chart from response
          exclude_total_data_chart_breakdown: true to exclude broken down chart from response
      """
      params = {
          'excludeTotalDataChart': str(exclude_total_data_chart).lower(),
          'excludeTotalDataChartBreakdown': str(exclude_total_data_chart_breakdown).lower()
      }
      result = await make_request('GET', f'/api/overview/dexs/{chain}', params)
      return str(result)

• defillama_server.py:766-766 (registration)

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

  @mcp.tool()

• defillama_server.py:772-780 (schema)

  Docstring providing API endpoint description, parameters, and usage examples, functioning as input/output schema documentation.

  """GET /api/overview/dexs/{chain}
  
  List all dexs along with summaries of their volumes and dataType history data filtering by chain.
  
  Parameters:
      chain: chain name (e.g., 'ethereum')
      exclude_total_data_chart: true to exclude aggregated chart from response
      exclude_total_data_chart_breakdown: true to exclude broken down chart from response
  """

• defillama_server.py:30-38 (helper)

  Shared helper function used by get_dex_overview_by_chain and other tools to perform HTTP requests to the DefiLlama API.

  async def make_request(method: str, endpoint: str, params: Optional[Dict[str, Any]] = None) -> Any:
      """Make a request to the DefiLlama API."""
      try:
          response = await client.request(method, endpoint, params=params)
          response.raise_for_status()
          return response.json()
      except Exception as e:
          return f"Error: {str(e)}"