Shumi AI

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.

Add to your MCP config (claude_desktop_config.json, orclaude mcp addfor Claude Code):

SetSHUMI_TOKENin 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 omitsenvrather than shipping a${SHUMI_TOKEN}string that would be passed through verbatim and fail as an invalid key.

Typed (deterministic):get_coin_risk,lookup_coin,resolve_coin,get_coin_sentiment,get_coin_historical,get_market_health,get_market_crossing,get_global_market,get_prices,scan_trends,scan_coins,get_market_sentiment,list_narratives,get_narrative,list_categories,get_category,get_funding_momentum,get_funding_alerts,get_regime,get_signal,get_signal_quality,get_pair_suggestions,list_rwa_assets,get_rwa_asset,get_holders,get_wallets,get_futures_signals,get_basket,get_transcripts.

Real-world assets(list_rwa_assets,get_rwa_asset) 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:ask_shumi(natural-language questions — Shumi classifies, fetches, and synthesizes) andsearch_web.

List-returning tools accepttop(keep first N items) andfields(comma-separated keys to keep) to save tokens.

Resources:shumi://capabilities(the data surface) andshumi://billing/tier(your current entitlement).

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.

PORT=8787 SHUMI_MCP_ALLOWED_ORIGINS=https://yourapp.com npm run start:http

Each request authenticates with its ownAuthorization: Bearer shumi_sk_*header; that token is forwarded to the upstream API per request. Endpoint:POST /mcp, health:GET /health.

The server is stateless.One endpoint serves both protocol revisions:

- 2026-07-28— noinitialize, noMcp-Session-Id. A request carries its own routing in headers (Mcp-Method, plusMcp-Nameontools/call) and its protocol envelope inparams._meta, so an intermediary can route and meter a call without parsing the body.
- 2025-11-25and earlier— still served. Old clients keep theirinitializehandshake, but each exchange is answered by its own instance rather than a session.

Because nothing outlives a request,GETandDELETE(the 2025 session operations) return405, and the session tunables that used to live here —SHUMI_MCP_SESSION_TTL_MS,SHUMI_MCP_MAX_SESSIONS,SHUMI_MCP_SESSION_SWEEP_MS— are gone. They are safe to delete from any deployment; unset they do nothing. The idle-session reaper they configured existed to stop liveness probes from growing the heap, which cannot happen when no session is kept.

npm install npm test # unit tests (no network) npm run inspect # open the MCP Inspector against the stdio server SHUMI_TOKEN=… npm start # run the stdio server

Two CLI routes have no MCP tool, both on purpose:

- walkforward— the route exists, but two of its three actions have nothing behind them while Engine B is paused: positions is empty and outcomes holds a single row from 2026-05-28. Shipping it would hand a caller an empty array with no reason attached. It goes in when the engine resumes.
- watch— server-sent events, which do not fit MCP tool semantics.

Everything else in the CLI's typed surface has a tool.

Remote MCP server for historical crypto & prediction-market data: search ~500K instruments, live market stats (OHLC, turnover, spreads, depth, slippage) and tick-data purchase. Keyless for catalog & stats; optional OAuth for account tools. Endpoint: https://cryptostruct.com/mcp

Read-only MCP server for your Evibe investment portfolio + live market data (holdings, performance, dividends, benchmarks, screeners). Works with Claude & ChatGPT.

Remote MCP server with real-money crypto casino audit data: trust scores, rankings, live payout tests, and T&C-decoded bonuses. No API key, Ed25519-signed answers. Endpoint: https://wagerx.io/mcp

Alpaca’s official MCP Server lets you trade stocks, ETFs, crypto, and options, run data analysis, and build strategies in plain English directly from your favorite LLM tools and IDEs

Live cross-DEX crypto prices read from on-chain pool state: per-venue price, liquidity depth and gross cross-venue spread across BSC, Polygon, Arbitrum, Base, Avalanche and Optimism. Works keyless, no account.

Bottom/top market-timing verdicts for 8 markets (crypto, stocks, commodities, FX, property) — x402 pay-per-call, no API key.

Read-only, sourced and timestamped prices for nine Binance Spot USDT markets through a public Streamable HTTP MCP endpoint.

Read-only crypto derivatives data for agents: funding, open interest, liquidations, options flow, COT, ETF flows, VPIN. 20 tools, no API key, hosted at https://mcp.bykaranteli.com

Pre-trade safety check for Solana tokens — traces coordinated wallet funding, same-block bundle buys and serial-launcher deployer history into one Exit-Liquidity Risk verdict before an agent buys.