list_exchanges_directory

Instructions

Implementation Reference

• coin_mcp/coingecko.py:409-429 (handler)

  The `list_exchanges_directory` MCP tool handler function. Decorated with @mcp.tool(), it calls `_cg_get('/exchanges', ...)` to fetch the CoinGecko exchanges directory with pagination (per_page capped at 1..250).

  @mcp.tool()
  async def list_exchanges_directory(per_page: int = 100, page: int = 1) -> Any:
      """List centralized exchanges from CoinGecko's directory, ranked by trust score / volume.
  
      This is CoinGecko's curated directory with metadata (year established,
      country, trust scores, 24h BTC-equivalent volume). For exchanges you can
      actually query in real time via this MCP, see `list_supported_exchanges`.
  
      Args:
          per_page: 1..250 exchanges per page.
          page: Page number.
  
      Returns:
          Array of exchanges with `id`, `name`, `year_established`, `country`,
          `url`, `image`, `trust_score`, `trust_score_rank`, `trade_volume_24h_btc`,
          `trade_volume_24h_btc_normalized`.
      """
      return await _cg_get(
          "/exchanges",
          {"per_page": max(1, min(per_page, 250)), "page": max(1, page)},
      )

• coin_mcp/coingecko.py:7-7 (registration)

  The `mcp` instance is imported from `coin_mcp.core`, and the `@mcp.tool()` decorator on line 409 registers this function as an MCP tool.

  from .core import _bool_str, _cg_get, mcp

• coin_mcp/coingecko.py:409-429 (schema)

  Input schema defined via type hints: `per_page: int = 100` (clamped 1-250) and `page: int = 1` (clamped >= 1). The return type is `Any` (JSON from CoinGecko).

  @mcp.tool()
  async def list_exchanges_directory(per_page: int = 100, page: int = 1) -> Any:
      """List centralized exchanges from CoinGecko's directory, ranked by trust score / volume.
  
      This is CoinGecko's curated directory with metadata (year established,
      country, trust scores, 24h BTC-equivalent volume). For exchanges you can
      actually query in real time via this MCP, see `list_supported_exchanges`.
  
      Args:
          per_page: 1..250 exchanges per page.
          page: Page number.
  
      Returns:
          Array of exchanges with `id`, `name`, `year_established`, `country`,
          `url`, `image`, `trust_score`, `trust_score_rank`, `trade_volume_24h_btc`,
          `trade_volume_24h_btc_normalized`.
      """
      return await _cg_get(
          "/exchanges",
          {"per_page": max(1, min(per_page, 250)), "page": max(1, page)},
      )

• coin_mcp/core.py:220-225 (helper)

  The `_cg_get` helper function used by the tool. It constructs the full CoinGecko API URL, adds auth headers, and delegates to the cached HTTP GET helper.

  async def _cg_get(path: str, params: dict[str, Any] | None = None) -> Any:
      return await _http_get(
          f"{_coingecko_base()}{path}",
          params=params,
          headers=_coingecko_headers(),
      )

• coin_mcp/core.py:96-96 (helper)

  The documentation/instructions table in `core.py` lists this tool as 'Browse all exchanges (CoinGecko directory) | list_exchanges_directory'.

  | Browse all exchanges (CoinGecko directory) | list_exchanges_directory |