Skip to content

ai.shumi/mcp

by shumi.ai · remote · local (npm) · no sign-in to list tools · v1.3.0 · published by ai.shumi

Crypto market intelligence: prices, funding rates, narratives, regime, and delta-neutral research.

Changes · 3

33 tools: 3 change things and 30 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http shumi https://mcp.shumi.ai/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

33 tools

Changes things 3Claude Code: ask
  • ask_shumiAsk Shumi any crypto-market question in natural language.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Ask Shumi any crypto-market question in natural language. Shumi classifies the query, fetches the relevant data, and returns a synthesized answer. Use this when no specific typed tool fits, or for multi-part / comparative questions.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • scan_coinsFilter the tracked universe by trend direction, category and market-cap band, and sort the result.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Filter the tracked universe by trend direction, category and market-cap band, and sort the result. For movers questions ("what's pumping", "top gainers/losers today", "biggest movers") use sort_by="change24h" ("change7d" for the week) — sort_order="desc" for gainers, "asc" for losers — and quote each row's change from the row itself (`change_24h_pct` / `change_7d_pct`, or `change24h` / `change7d`). With the default marketCap sort rows are plain coin names; a change sort may return `{ rows: [...] }` with a coverage summary instead of a bare list. Pass ONE category per call; the server ignores case and punctuation ("meme", "Layer 2" and "DeFi" all work) and rejects an unknown name with close matches (list_categories has the names). There is no exchange filter yet: `exchange` is rejected with an explanation, because the only venue data behind this scan is spot listings. Do not present a scan as "coins on <exchange>". An empty result means no coin matched all the filters.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
Only reads 30Claude Code: allow
  • get_basketDaily snapshots of the tracked basket — composition and performance over time.No findings

    Why it is in this group

    • The name "get_basket" says "get": a word for reading.
    Description, as the server wrote it
    Daily snapshots of the tracked basket — composition and performance over time.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_categoryDetail for one category.No findings

    Why it is in this group

    • The name "get_category" says "get": a word for reading.
    Description, as the server wrote it
    Detail for one category. view=info (trend breakdown), coins (member coins), sentiment.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_coin_historicalMarket cap, volume, open interest, funding rate and price for a coin AS OF a chosen point in the past.No findings

    Why it is in this group

    • The name "get_coin_historical" says "get": a word for reading.
    Description, as the server wrote it
    Market cap, volume, open interest, funding rate and price for a coin AS OF a chosen point in the past. Returns a single snapshot, not a series: call it once per point you want to compare (e.g. amount=7 interval=d for a week ago, then again with no offset for now). Use this to answer "how has funding/open interest changed since…".

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_coin_riskBundled risk context for one or more coins: price, funding APR, deterministic funding_paying_side, funding_receiving_side, carry_if_long and carry_if_short fields, daily/weekly tre…No findings

    Why it is in this group

    • The name "get_coin_risk" says "get": a word for reading.
    Description, as the server wrote it
    Bundled risk context for one or more coins: price, funding APR, deterministic funding_paying_side, funding_receiving_side, carry_if_long and carry_if_short fields, daily/weekly trend, sentiment stance, and BTC correlation. Funding applies to perpetual positions only; spot positions neither pay nor receive it. Relay the carry fields exactly rather than inferring direction from crowding. The best single tool for "should I be worried about X".

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_coin_sentimentOn-chain/social sentiment aggregates for a single coin.No findings

    Why it is in this group

    • The name "get_coin_sentiment" says "get": a word for reading.
    Description, as the server wrote it
    On-chain/social sentiment aggregates for a single coin.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_funding_alertsDiscrete funding-rate alert events (asset, trigger zone, funding at trigger, fired-at time).No findings

    Why it is in this group

    • The name "get_funding_alerts" says "get": a word for reading.
    Description, as the server wrote it
    Discrete funding-rate alert events (asset, trigger zone, funding at trigger, fired-at time).

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_funding_momentumPerpetual funding-rate positioning context, market-wide or for one symbol.No findings

    Why it is in this group

    • The name "get_funding_momentum" says "get": a word for reading.
    Description, as the server wrote it
    Perpetual funding-rate positioning context, market-wide or for one symbol. APR is already in percent units (1.7 = 1.7%). Positive funding means longs pay and shorts receive; negative funding means shorts pay and longs receive. Funding is context only, not a standalone directional, timing, or entry signal.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_futures_signalsPerpetual-futures signal engine.No findings

    Why it is in this group

    • The name "get_futures_signals" says "get": a word for reading.
    Description, as the server wrote it
    Perpetual-futures signal engine. view=state (currently open signals), log (recent fires), history (one asset's past signals — needs asset).

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_global_marketGlobal market aggregates: BTC dominance, total market cap, total volume.No findings

    Why it is in this group

    • The name "get_global_market" says "get": a word for reading.
    Description, as the server wrote it
    Global market aggregates: BTC dominance, total market cap, total volume.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_holdersTracked token-holder cohorts.No findings

    Why it is in this group

    • The name "get_holders" says "get": a word for reading.
    Description, as the server wrote it
    Tracked token-holder cohorts. view=watchlist (which token contracts are tracked), movements (recent holder-count changes for one contract). Answers "is the holder base growing or bleeding?".

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_market_crossingThe most recent regime crossing — when one trend cohort (UP/HODL/DOWN) overtook another market-wide.No findings

    Why it is in this group

    • The name "get_market_crossing" says "get": a word for reading.
    Description, as the server wrote it
    The most recent regime crossing — when one trend cohort (UP/HODL/DOWN) overtook another market-wide. Answers "has the market flipped?". Returns an empty `crossings` array plus a message when no crossing has fired.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_market_healthOverall market health: the UP/HODL/DOWN trend distribution and extreme movers.No findings

    Why it is in this group

    • The name "get_market_health" says "get": a word for reading.
    Description, as the server wrote it
    Overall market health: the UP/HODL/DOWN trend distribution and extreme movers. Set context for the full bundle.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_market_sentimentAggregate market sentiment.No findings

    Why it is in this group

    • The name "get_market_sentiment" says "get": a word for reading.
    Description, as the server wrote it
    Aggregate market sentiment. view=market/latest/summary (overall), narratives, categories, slopes/entity-slopes (what is trending), health (pipeline status).

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_narrativeSentiment and momentum for a single named narrative.No findings

    Why it is in this group

    • The name "get_narrative" says "get": a word for reading.
    Description, as the server wrote it
    Sentiment and momentum for a single named narrative.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_pair_suggestionsPair-trading and delta-neutral funding-arbitrage intelligence.No findings

    Why it is in this group

    • The name "get_pair_suggestions" says "get": a word for reading.
    Description, as the server wrote it
    Pair-trading and delta-neutral funding-arbitrage intelligence. mode=suggestions (pair ideas), delta-neutral (funding arb), history (backtest), signal (state for a specific pair — needs token_a & token_b).

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_pricesBulk live prices, optionally with 4h/24h/7d baseline overlays.No findings

    Why it is in this group

    • The name "get_prices" says "get": a word for reading.
    Description, as the server wrote it
    Bulk live prices, optionally with 4h/24h/7d baseline overlays. Omit symbols for the full tracked set.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_regimeMarket regime signals.No findings

    Why it is in this group

    • The name "get_regime" says "get": a word for reading.
    Description, as the server wrote it
    Market regime signals. view=active (current positions), signals (all), confidence (scores). Provide symbol to get that symbol's regime history instead.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_rwa_assetPrice, daily/weekly trend and perp funding for one real-world asset (stock, ETF, commodity, index, FX).No findings

    Why it is in this group

    • The name "get_rwa_asset" says "get": a word for reading.
    Description, as the server wrote it
    Price, daily/weekly trend and perp funding for one real-world asset (stock, ETF, commodity, index, FX). Look up by ticker (AAPL, GOLD) or by namespaced id (xyz:AAPL). Funding belongs to the PERPETUAL CONTRACT, not the underlying — `funding.apr` is the annualized rate in percent, `funding.rate` is the raw per-hour fraction. Do not use the crypto coin tools for these.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_signalSynthesized verdict for a coin, combining trend, funding, sentiment and regime.No findings

    Why it is in this group

    • The name "get_signal" says "get": a word for reading.
    Description, as the server wrote it
    Synthesized verdict for a coin, combining trend, funding, sentiment and regime.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_signal_qualitySignal validation envelope for an asset: Sharpe ratio, win rate, sample size, reliability tier.No findings

    Why it is in this group

    • The name "get_signal_quality" says "get": a word for reading.
    Description, as the server wrote it
    Signal validation envelope for an asset: Sharpe ratio, win rate, sample size, reliability tier.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_transcriptsHighlights mined from tracked video/podcast transcripts.No findings

    Why it is in this group

    • The name "get_transcripts" says "get": a word for reading.
    Description, as the server wrote it
    Highlights mined from tracked video/podcast transcripts. view=highlights (extracted claims with the coins, sectors and macro tags they mention), sources (which channels are tracked). Answers "what are people actually saying about X?".

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_unlock_calendarUpcoming token unlocks ACROSS THE MARKET when no single coin is named: each row has date, days until, coin, tokens, USD value, % of market cap, recipients and insider (team + inves…No findings

    Why it is in this group

    • The name "get_unlock_calendar" says "get": a word for reading.
    Description, as the server wrote it
    Upcoming token unlocks ACROSS THE MARKET when no single coin is named: each row has date, days until, coin, tokens, USD value, % of market cap, recipients and insider (team + investor) share, with its source. Defaults: next 7 days, top 500 coins, at least 0.5 % of market cap, ranked by % of market cap. Only coins DropsTab tracks; each recipient's next release only. Answers "biggest unlocks this week?", "big VC unlocks this month?". For one coin use get_unlocks.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_unlocksScheduled token unlocks for ONE coin: the next unlock (date, days until, tokens, USD value, % of market cap, recipients such as team/investors/ecosystem, cliff or monthly tranche),…No findings

    Why it is in this group

    • The name "get_unlocks" says "get": a word for reading.
    Description, as the server wrote it
    Scheduled token unlocks for ONE coin: the next unlock (date, days until, tokens, USD value, % of market cap, recipients such as team/investors/ecosystem, cliff or monthly tranche), what releases over 30 and 90 days, % unlocked and locked, the final unlock date, the last unlock, and how price moved in the 7 days before and after its last 3-6 unlocks (history, not a forecast). Sources: DropsTab cross-checked with DefiLlama, each figure with its source link and fetch time; `state` says `upcoming`, `fully_unlocked`, `no_unlock_data` or `not_covered` (then `publishedSchedule` may carry the project's own vesting terms). Answers "when is ARB's next unlock?", "who gets the OP unlock?", "how did SUI trade around its unlocks?".

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • get_walletsTracked wallets.No findings

    Why it is in this group

    • The name "get_wallets" says "get": a word for reading.
    Description, as the server wrote it
    Tracked wallets. view=watchlist (which wallets are tracked), movements (recent balance changes for one wallet address). Answers "what did this wallet do recently?".

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • list_categoriesList tracked crypto categories by their exact names (e.g.No findings

    Why it is in this group

    • The name "list_categories" says "list": a word for reading.
    Description, as the server wrote it
    List tracked crypto categories by their exact names (e.g. "Meme", "Layer-2"), the names scan_coins expects.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • list_narrativesList the currently active market narratives (e.g.No findings

    Why it is in this group

    • The name "list_narratives" says "list": a word for reading.
    Description, as the server wrote it
    List the currently active market narratives (e.g. "AI coins", "DeFi summer").

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • list_rwa_assetsList the tradable real-world assets — stocks and ETFs (AAPL, NVDA, SPY), metals and commodities (GOLD, SILVER, BRENT), stock indices (SP500, JP225) and FX.No findings

    Why it is in this group

    • The name "list_rwa_assets" says "list": a word for reading.
    Description, as the server wrote it
    List the tradable real-world assets — stocks and ETFs (AAPL, NVDA, SPY), metals and commodities (GOLD, SILVER, BRENT), stock indices (SP500, JP225) and FX. These trade as perps on Hyperliquid builder DEXes and are NOT crypto tokens; the crypto tools will not find them. Use this to answer "which stocks/commodities can I look at?".

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • lookup_coinLook up a single coin and its core metrics (price, trend, metadata) by symbol, name, CoinGecko/internal id, or on-chain contract address.No findings

    Why it is in this group

    • The name "lookup_coin" says "lookup": a word for reading.
    Description, as the server wrote it
    Look up a single coin and its core metrics (price, trend, metadata) by symbol, name, CoinGecko/internal id, or on-chain contract address. Read the coin's CURRENT trend from `currentTrend` ({ trend: UP|DOWN|HODL, since, days, asOf, incompleteDayExcluded }; `currentTrendWeekly` when present is the weekly one), not from the last row of `trends` — `trends` is the history of past trend runs. Quote it as "<trend> since <since> (<days> days, as of <asOf>)". Only when `currentTrend` is absent, fall back to the last `trends` row.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • resolve_coinFuzzily resolve a symbol, name, or contract to canonical coin candidates.No findings

    Why it is in this group

    • The name "resolve_coin" says "resolve": a word for reading.
    Description, as the server wrote it
    Fuzzily resolve a symbol, name, or contract to canonical coin candidates. Use this first when the user input is ambiguous, before calling other tools.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • search_webSearch the web for crypto information, or get a direct answer.No findings

    Why it is in this group

    • The name "search_web" says "search": a word for reading.
    Description, as the server wrote it
    Search the web for crypto information, or get a direct answer. Backed by Shumi's web-search tool.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.3.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http shumi https://mcp.shumi.ai/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__shumi__get_coin_risk",
      "mcp__shumi__lookup_coin",
      "mcp__shumi__resolve_coin",
      "mcp__shumi__get_coin_sentiment",
      "mcp__shumi__get_coin_historical",
      "mcp__shumi__get_market_health",
      "mcp__shumi__get_global_market",
      "mcp__shumi__get_market_crossing",
      "mcp__shumi__get_prices",
      "mcp__shumi__get_market_sentiment",
      "mcp__shumi__list_narratives",
      "mcp__shumi__get_narrative",
      "mcp__shumi__list_categories",
      "mcp__shumi__get_category",
      "mcp__shumi__get_funding_momentum",
      "mcp__shumi__get_funding_alerts",
      "mcp__shumi__get_regime",
      "mcp__shumi__get_signal",
      "mcp__shumi__get_signal_quality",
      "mcp__shumi__get_pair_suggestions",
      "mcp__shumi__list_rwa_assets",
      "mcp__shumi__get_rwa_asset",
      "mcp__shumi__get_unlocks",
      "mcp__shumi__get_unlock_calendar",
      "mcp__shumi__get_holders",
      "mcp__shumi__get_wallets",
      "mcp__shumi__get_futures_signals",
      "mcp__shumi__get_basket",
      "mcp__shumi__get_transcripts",
      "mcp__shumi__search_web"
    ],
    "ask": [
      "mcp__shumi__scan_trends",
      "mcp__shumi__scan_coins",
      "mcp__shumi__ask_shumi"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as shumi. Review it before you use it.