Title99/100
Get coin market data
The title clearly communicates the tool’s action and subject. Keep it concise.
Description94/100
Get current market data (price, market cap, 24h volume, market cap rank) for a list of CoinGecko coin ids, or for the top N coins by market cap, and display it in a visual widget. Provide either ids or topN, not both. Use this when the user asks for the price or market data of specific coins, or for a top-N leaderboard by market cap. To compare or contrast 2–4 specific coins (e.g. "BTC vs ETH"), use compare-coins instead. Not for historical prices (use get-coin-market-chart) and not financial advice.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
ids
CoinGecko coin *ids* (not tickers), e.g. ["bitcoin", "ethereum", "solana", "zcash"]. Up to 20. Map user tickers/names to ids yourself.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
topN
Return the top N coins by market cap (1–20). Provide either ids or topN, not both; ids wins if both are given.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations75/100
Declare idempotentHint based on the tool’s actual behavior.
{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}Output schema90/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"coins"
],
"properties": {
"coins": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"symbol",
"name",
"image",
"currentPrice",
"marketCap",
"marketCapRank",
"totalVolume",
"priceChangePercentage24h",
"fullyDilutedValuation",
"circulatingSupply",
"maxSupply",
"sparkline7d"
],
"properties": {
"id": {
"type": "string",
"description": "CoinGecko coin id, e.g. 'bitcoin'"
},
"name": {
"type": "string",
"description": "Display name, e.g. 'Bitcoin'"
},
"image": {
"type": "string",
"description": "URL to the coin's logo image"
},
"symbol": {
"type": "string",
"description": "Ticker symbol, e.g. 'btc'"
},
"marketCap": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Market capitalization in USD, or null if unavailable"
},
"maxSupply": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Max supply in coin units, or null if uncapped/unavailable"
},
"sparkline7d": {
"type": "array",
"items": {
"type": "number"
},
"description": "7-day price series in USD (downsampled, oldest first)"
},
"totalVolume": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "24h trading volume in USD, or null if unavailable"
},
"currentPrice": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Current price in USD, or null if unavailable"
},
"marketCapRank": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Market cap rank, or null if unranked"
},
"circulatingSupply": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Circulating supply in coin units, or null if unavailable"
},
"fullyDilutedValuation": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Fully diluted valuation in USD, or null if unavailable"
},
"priceChangePercentage24h": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "24h price change percentage, or null if unavailable"
}
},
"additionalProperties": false
},
"description": "Market data for each requested coin"
}
},
"additionalProperties": false
}