Shumi MCP server
online · 100% uptimeai.shumi/mcp·v1.3.0·2 starsCrypto market intelligence: prices, funding rates, narratives, regime, and delta-neutral research.
2 stars155 downloads/wk
Reviews
Write oneNobody has reviewed Shumi yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Shumi tools (33)
write = sends, deletes, buys or postsask_shumiFreeAsk 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.
get_basketFreeDaily snapshots of the tracked basket — composition and performance over time.
get_categoryFreeDetail for one category. view=info (trend breakdown), coins (member coins), sentiment.
get_coin_historicalFreeMarket 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…".
get_coin_riskFreeBundled 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".
get_coin_sentimentFreeOn-chain/social sentiment aggregates for a single coin.
get_funding_alertsFreeDiscrete funding-rate alert events (asset, trigger zone, funding at trigger, fired-at time).
get_funding_momentumFreePerpetual 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.
get_futures_signalsFreePerpetual-futures signal engine. view=state (currently open signals), log (recent fires), history (one asset's past signals — needs asset).
get_global_marketFreeGlobal market aggregates: BTC dominance, total market cap, total volume.
get_holdersFreeTracked 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?".
get_market_crossingFreeThe 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.
get_market_healthFreeOverall market health: the UP/HODL/DOWN trend distribution and extreme movers. Set context for the full bundle.
get_market_sentimentFreeAggregate market sentiment. view=market/latest/summary (overall), narratives, categories, slopes/entity-slopes (what is trending), health (pipeline status).
get_narrativeFreeSentiment and momentum for a single named narrative.
get_pair_suggestionsFreePair-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).
get_pricesFreeBulk live prices, optionally with 4h/24h/7d baseline overlays. Omit symbols for the full tracked set.
get_regimeFreeMarket regime signals. view=active (current positions), signals (all), confidence (scores). Provide symbol to get that symbol's regime history instead.
get_rwa_assetFreePrice, 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.
get_signalFreeSynthesized verdict for a coin, combining trend, funding, sentiment and regime.
get_signal_qualityFreeSignal validation envelope for an asset: Sharpe ratio, win rate, sample size, reliability tier.
get_transcriptsFreeHighlights 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?".
get_unlock_calendarFreeUpcoming 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.
get_unlocksFreeScheduled 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?".
get_walletsFreeTracked wallets. view=watchlist (which wallets are tracked), movements (recent balance changes for one wallet address). Answers "what did this wallet do recently?".
list_categoriesFreeList tracked crypto categories by their exact names (e.g. "Meme", "Layer-2"), the names scan_coins expects.
list_narrativesFreeList the currently active market narratives (e.g. "AI coins", "DeFi summer").
list_rwa_assetsFreeList 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?".
lookup_coinFreeLook 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.
resolve_coinFreeFuzzily resolve a symbol, name, or contract to canonical coin candidates. Use this first when the user input is ambiguous, before calling other tools.
scan_coinsFreeFilter 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.
scan_trendsFreeTrend scanner. state=fresh (newly started), stale (longest running), aligned (multi-timeframe agreement), extreme (biggest moves), historical.
search_webFreeSearch the web for crypto information, or get a direct answer. Backed by Shumi's web-search tool.
Public scan report
scanner v0.1.10 · 2026-10-31 · same rubric, same numbers if you re-run it
- Code scan17 source files scanned25/25
- Live reliabilityremote reachable in 1024ms20/20
- Tool poisoning33 tool descriptions checked15/15
- Auth qualityopen endpoint, read-only tools10/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityendpoint served from the registry-verified namespace domain8/10
How Shumi compares
Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 93/100
- higher than 96% of 1,759 Finance servers
- Tools
- 33
- the typical Finance server has 8
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote Finance server answers 100%
- Response time
- 345 ms
- faster than 46% of 1,131 Finance servers
- GitHub stars
- 2
- more than 80% of 945 Finance servers
- Downloads a week
- 155
- more than 77% of 422 Finance servers with a package
What its tools let an agent do: 33 read
Release history: 3 versions in the registry since 2026-08-26, latest 2026-10-14, typically one every 29 days.
Install Shumi in Claude Code, Cursor or VS Code
claude mcp add --transport http mcp https://mcp.shumi.ai/mcp
What the publisher says
From the Shumi repository's README, as published. We do not edit it. Read it on GitHub
@shumi-ai/mcp
Shumi crypto trade-intelligence as an MCP server — the same market intelligence the shumi CLI provides, for any MCP client (Claude Desktop, Claude Code, Cursor, agents).
It's a thin wrapper over Shumi's data API: prices, trends, funding rates, sentiment, narratives, market regime, synthesized signals, pair / delta-neutral ideas, real-world assets, holder and wallet tracking, and transcript highlights. All tools are read-only.
Quick start
You need a Shumi API key (shumisk…). Create one at .
Claude Desktop / Claude Code
Add to your MCP config (claudedesktopconfig.json, or claude mcp add for Claude Code):
{
"mcpServers": {
"shumi": {
"command": "npx",
"args": ["-y", "@shumi-ai/mcp"],
"env": {
"SHUMI_TOKEN": "shumi_sk_your_key_here"
}
}
}
}Restart the client. The shumi tools (e.g. getcoinrisk, getmarkethealth, ask_shumi) appear automatically.
Cursor
~/.cursor/mcp.json uses the same command / args / env shape as above.
Plugin directories
This repo also ships plugin.json and mcp.json at its root, so it installs as an Agent Plugin from Cursor's directory and any other client on that standard.
Set SHUMITOKEN in your environment before starting the client when you install this way. The Agent Plugins schema takes literal environment values only — it has no placeholder for a secret — so the manifest deliberately omits env rather than shipping a ${SHUMITOKEN} string that would be passed through verbatim and fail as an invalid key.
Tools
Typed (deterministic): getcoinrisk, lookupcoin, resolvecoin, getcoinsentiment, getcoinhistorical, getmarkethealth, getmarketcrossing, getglobalmarket, getprices, scantrends, scancoins, getmarketsentiment, listnarratives, getnarrative, listcategories, getcategory, getfundingmomentum, getfundingalerts, getregime, getsignal, getsignalquality, getpairsuggestions, listrwaassets, getrwaasset, getholders, getwallets, getfuturessignals, getbasket, get_transcripts.
Real-world assets (listrwaassets, getrwaasset) cover stocks, ETFs, commodities, indices and FX trading as perps on Hyperliquid builder DEXes. They are not crypto tokens — the coin tools will not find them.
Free-form: askshumi (natural-language questions — Shumi classifies, fetches, and synthesizes) and searchweb.
List-returning tools accept top (keep first N items) and fields (comma-separated keys to keep) to save tokens.
Resources: shumi://capabilities (the data surface) and shumi://billing/tier (your current entitlement).
Configuration
Gating (free / access / pro tiers and pay-per-call) is enforced server-side, exactly as for the CLI — out-of-quota responses come back as a structured error with an actionable hint.
Remote (HTTP)
For a hosted, multi-user deployment:
PORT=8787 SHUMI_MCP_ALLOWED_ORIGINS=https://yourapp.com npm run start:httpEach request authenticates with its own key header; that token is forwarded to the upstream API per request. Endpoint: POST /mcp, health: GET /health.
Connecting from Claude (static_headers)
Claude supports a fixed credential entered as a request header, so no OAuth server is needed. In Add custom connector → request headers, an organisation administrator enters:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Shumi: common questions
- Is Shumi MCP server safe?
- Yes, by our scan: it is graded A (93/100). Read the Shumi safety report
- How do I install Shumi?
- It runs remotely at mcp.shumi.ai. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Shumi need an API key?
- Yes. The registry entry asks for
SHUMI_TOKEN. - Is Shumi maintained?
- The last commit was 7 days ago (2026-10-29). The latest release is v1.3.0.
- Is Shumi up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of Shumi?
- Servers from other publishers that do the same job: Blockrun MCP server, Coinversaa MCP server and Truss44 Crypto Price MCP server. Compare all Shumi alternatives.
- How does Shumi compare with other Finance MCP servers?
- safety score 93/100 (higher than 96% of 1,759 Finance servers); tools 33 (the typical Finance server has 8); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Shumi
Same job from other publishers: the closest match first, then the best rated.
- BlockrunWeb search, deep research, prediction markets & crypto data for AI agents. Pay per call via x402.not reviewedEstablishedB
- CoinversaaCrypto intelligence for AI agents. Hyperliquid trader analytics, cohorts, and live market data.not reviewedGrowingB
- Truss44 Crypto PriceProvide real-time cryptocurrency price data and market analysis.not reviewedGrowingA
- CoinPaprikaReal-time crypto market data: prices, tickers, exchanges, OHLCV candles, and metadata.not reviewedGrowingB
- Tapetide - Indian Stock Market MCP48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, optionsnot reviewedEstablishedA