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.
33 tools: 3 change things and 30 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things3Claude Code: ask: see these tools
- Only reads30Claude Code: allow: see these tools
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/mcpTools
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
scan_trendsTrend scanner.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 Trend scanner. state=fresh (newly started), stale (longest running), aligned (multi-timeframe agreement), extreme (biggest moves), historical.
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/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .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.