data
CoinGecko MCP, CLI, and Lua Integration for AI Agents
CoinGecko integration docs for AI agents: MCP gateway setup, CoinGecko CLI commands, Lua API reference, credentials, and function schemas.CoinGecko for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Agent Surfaces
Machine-Readable Metadata
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
coingecko.coingecko_api_get | Read read | 2 | Call any CoinGecko API v3 GET path not covered by a first-class tool, such as /derivatives or /nfts/list. |
coingecko.coingecko_categories_market_data | Read read | 1 | List CoinGecko categories with market cap, volume, and top coin data. |
coingecko.coingecko_coin_history_date | Read read | 3 | Get historical coin data for a calendar date in dd-mm-yyyy format. |
coingecko.coingecko_coin_tickers | Read read | 2 | Get centralized and decentralized exchange tickers for a CoinGecko coin ID. |
coingecko.coingecko_exchange_rates | Read read | 0 | Get BTC-to-currency exchange rates for fiat and crypto units. |
coingecko.coingecko_exchange_volume_chart | Read read | 2 | Get historical exchange volume chart data in BTC. |
coingecko.coingecko_get_exchange | Read read | 1 | Get exchange profile data, volume, and tickers by CoinGecko exchange ID. |
coingecko.coingecko_get_exchange_tickers | Read read | 2 | Get market tickers for a CoinGecko exchange ID. |
coingecko.coingecko_global | Read read | 0 | Get overall crypto market statistics — total market cap, BTC dominance, active cryptocurrencies, trading volume, and more. |
coingecko.coingecko_global_defi | Read read | 0 | Get global DeFi market cap, volume, dominance, and related aggregate metrics. |
coingecko.coingecko_history | Read read | 3 | Get historical price, volume, and market cap chart data for a cryptocurrency over a time period. Returns timestamped data points with summary statistics. |
coingecko.coingecko_info | Read read | 1 | Get a full coin profile — description, categories, links (website, whitepaper, social), and current market data snapshot. Use `coingecko_search_coins` first to find the coin ID. |
coingecko.coingecko_list_asset_platforms | Read read | 1 | List asset platform IDs and chain metadata used by token-price and token-list endpoints. |
coingecko.coingecko_list_categories | Read read | 0 | List CoinGecko category IDs for filtering market data. |
coingecko.coingecko_list_coins | Read read | 1 | List supported CoinGecko coin IDs, symbols, names, and optional asset-platform contract addresses. |
coingecko.coingecko_list_entities | Read read | 0 | List public companies and governments supported by CoinGecko public treasury endpoints. |
coingecko.coingecko_list_exchange_ids | Read read | 0 | List exchange IDs and names for exchange-specific tools. |
coingecko.coingecko_list_exchanges | Read read | 1 | List active exchanges with country, trust score, and 24-hour BTC volume data. |
coingecko.coingecko_markets | Read read | 6 | Get top cryptocurrencies ranked by market cap with full market data (price, volume, ATH, supply, price changes). Supports filtering by category or specific coin IDs. |
coingecko.coingecko_new_coins | Read read | 0 | List the latest coins recently added to CoinGecko. |
coingecko.coingecko_ohlc | Read read | 3 | Get OHLC (Open/High/Low/Close) candlestick data for a cryptocurrency for technical analysis. |
coingecko.coingecko_price | Read read | 2 | Get current price for one or more cryptocurrencies (by CoinGecko ID). Includes 24h change, volume, and market cap. Use `coingecko_search_coins` first to find coin IDs. |
coingecko.coingecko_public_treasury_by_coin | Read read | 3 | Get public company or government crypto treasury holdings by CoinGecko coin ID. |
coingecko.coingecko_public_treasury_entity | Read read | 2 | Get public treasury holdings for a public company or government entity ID. |
coingecko.coingecko_search_coins | Read read | 1 | Find cryptocurrencies by name or ticker symbol (e.g. "bitcoin", "ETH", "solana"). Returns matching coin IDs which are needed for other CoinGecko tools. |
coingecko.coingecko_simple_token_price | Read read | 3 | Get token prices by asset platform ID and token contract address. |
coingecko.coingecko_token_list | Read read | 1 | Get the token list for an asset platform, such as ethereum or polygon-pos. |
coingecko.coingecko_top_gainers_losers | Read read | 2 | Get top gainers and losers for a target currency and time duration. |
coingecko.coingecko_trending | Read read | 0 | Get the top trending cryptocurrencies in the last 24 hours based on search activity on CoinGecko. |