Home/Docs/MCP Tools

MCP Tools

8 tools for crypto intelligence. Use them from Claude Desktop, Cursor, or any MCP client.

get_market_overview

Public

Get the current cryptocurrency market overview including total market cap, BTC dominance, 24h volume, sentiment score, short summary, and top 5 gainers/losers.

No parameters required.

Example Response

{
    "date": "2026-03-21",
    "market_cap": 2850000000000,
    "btc_dominance": 52.4,
    "volume_24h": 98500000000,
    "sentiment_score": 3,
    "short_summary": "Markets trending bullish with BTC leading recovery.",
    "top_gainers": [
        {
            "symbol": "SOL",
            "name": "Solana",
            "percent_change_24h": 8.5
        }
    ],
    "top_losers": [
        {
            "symbol": "DOGE",
            "name": "Dogecoin",
            "percent_change_24h": -3.2
        }
    ]
}

search_cryptos

Public

Search cryptocurrencies by name, symbol, or slug. Returns up to 10 results sorted by market cap rank.

Parameters

NameTypeRequiredDescription
querystringYesSearch term to match against cryptocurrency name, symbol, or slug.

Example Response

{
    "results": [
        {
            "id": 1,
            "symbol": "BTC",
            "name": "Bitcoin",
            "slug": "bitcoin",
            "rank": 1,
            "latest_price": 87500,
            "percent_change_24h": 2.15,
            "market_cap": 1720000000000,
            "average_sentiment": 0.72
        }
    ],
    "count": 1
}

get_crypto_details

Public

Get detailed information about a specific cryptocurrency including price, market cap, supply, rank, and recent performance.

Parameters

NameTypeRequiredDescription
identifierstringYesCryptocurrency identifier: symbol (BTC), slug (bitcoin), or numeric ID.

Example Response

{
    "id": 1,
    "symbol": "BTC",
    "name": "Bitcoin",
    "slug": "bitcoin",
    "rank": 1,
    "type": "coin",
    "latest_price": 87500,
    "percent_change_1h": 0.35,
    "percent_change_24h": 2.15,
    "percent_change_7d": 5.8,
    "percent_change_30d": 12.4,
    "market_cap": 1720000000000,
    "volume_24h": 45000000000,
    "circulating_supply": 19700000,
    "total_supply": 21000000,
    "max_supply": 21000000,
    "num_market_pairs": 11200,
    "is_verified_market_cap": true,
    "opinions_count": 1540,
    "weekly_opinions_count": 87,
    "average_sentiment": 0.72
}

get_opinions

Requires API Key

Get expert crypto opinions and trading signals. Filters by cryptocurrency, signal type, recency, and importance. Returns up to 20 opinions with source attribution and profit tracking.

Parameters

NameTypeRequiredDescription
cryptostringNoSymbol, slug, or ID to filter by a specific cryptocurrency.
signalstringNoSignal slug to filter by (e.g., "buy", "sell", "strong-buy").
daysintegerNoHow many days back to look. Default 7, max 30.
importance_minintegerNoMinimum importance level (1-5).

Example Response

{
    "opinions": [
        {
            "id": 12345,
            "title": "Bitcoin bullish breakout imminent",
            "short_text": "BTC showing strong support at $85k with increasing volume.",
            "source": "CryptoAnalyst",
            "crypto": {
                "symbol": "BTC",
                "name": "Bitcoin"
            },
            "signal": {
                "name": "Strong Buy",
                "slug": "strong-buy"
            },
            "published_at": "2026-03-21T14:30:00+00:00",
            "importance": 4
        }
    ],
    "count": 1,
    "filters": {
        "days": 7,
        "crypto": "BTC",
        "signal": null,
        "importance_min": null
    }
}

get_market_recap

Requires API Key

Get the AI-generated daily market recap with narrative summary, sentiment scores, key movers, and market stats. Optionally include hourly breakdown.

Parameters

NameTypeRequiredDescription
datestringNoDate in YYYY-MM-DD format. Defaults to the latest available date.
include_hourlybooleanNoInclude hourly market data breakdown. Default: false.

Example Response

{
    "date": "2026-03-21",
    "short_summary": "Markets trending bullish with BTC leading recovery.",
    "narrative": "Bitcoin surged past $87,000 today as institutional interest...",
    "sentiment": {
        "market_score": 3,
        "llm_score": 7,
        "confidence": 0.82
    },
    "market_stats": {
        "total_market_cap": 2850000000000,
        "volume_24h": 98500000000,
        "btc_dominance": 52.4
    },
    "key_movers": [
        {
            "symbol": "SOL",
            "change": 8.5,
            "reason": "DEX volume surge"
        }
    ]
}

get_sentiment_analysis

Requires API Key

Get aggregated sentiment analysis for a specific cryptocurrency or the overall market. Counts buy vs sell opinions and returns bullish/bearish percentages.

Parameters

NameTypeRequiredDescription
cryptostringNoSymbol, slug, or ID. If omitted, returns market-level sentiment.
daysintegerNoPeriod for analysis in days. Default 7, max 30.

Example Response

{
    "mode": "crypto",
    "crypto": {
        "symbol": "BTC",
        "name": "Bitcoin",
        "slug": "bitcoin"
    },
    "period_days": 7,
    "buy_count": 42,
    "sell_count": 15,
    "neutral_count": 8,
    "total": 65,
    "bullish_percent": 64.6,
    "breakdown": [
        {
            "signal": "Strong Buy",
            "slug": "strong-buy",
            "count": 18
        },
        {
            "signal": "Buy",
            "slug": "buy",
            "count": 24
        },
        {
            "signal": "Sell",
            "slug": "sell",
            "count": 15
        }
    ]
}

compare_cryptos

Requires API Key

Compare 2 to 5 cryptocurrencies side by side. Returns price, market cap, volume, percent changes, sentiment, and opinions count for each.

Parameters

NameTypeRequiredDescription
identifiersarrayYesArray of 2-5 cryptocurrency identifiers (symbols, slugs, or numeric IDs).

Example Response

{
    "compared": [
        {
            "symbol": "BTC",
            "name": "Bitcoin",
            "slug": "bitcoin",
            "rank": 1,
            "latest_price": 87500,
            "market_cap": 1720000000000,
            "volume_24h": 45000000000,
            "percent_change_24h": 2.15,
            "percent_change_7d": 5.8,
            "percent_change_30d": 12.4,
            "average_sentiment": 0.72,
            "opinions_count": 1540
        },
        {
            "symbol": "ETH",
            "name": "Ethereum",
            "slug": "ethereum",
            "rank": 2,
            "latest_price": 3200,
            "market_cap": 385000000000,
            "volume_24h": 18000000000,
            "percent_change_24h": 1.8,
            "percent_change_7d": 4.2,
            "percent_change_30d": 9.1,
            "average_sentiment": 0.65,
            "opinions_count": 980
        }
    ],
    "fields": [
        "price",
        "market_cap",
        "volume_24h",
        "percent_change_24h",
        "percent_change_7d",
        "percent_change_30d",
        "circulating_supply",
        "average_sentiment",
        "opinions_count"
    ]
}

Ready to Get Started?

Follow the Quick Start guide to connect your client and make your first query.

HomeRecapsAI ChatPricing
Menu
AI ChatMarket RecapsAPI & MCPDark Mode