Mmcp.market

MCP server

by shumi.ai·ai.shumi/mcp·v1.1.1
No reviews yet

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

A91/100grade A
Write a reviewRun it
What users say
No reviews yet
Be the first
Safety scan
A91/100

full report

Adoption
Growing

2 stars96 downloads/wk

Reviews

Write one

Nobody has reviewed MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

MCP tools (31)

write = sends, deletes, buys or posts
  • ask_shumiFree

    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.

  • get_basketFree

    Daily snapshots of the tracked basket — composition and performance over time.

  • get_categoryFree

    Detail for one category. view=info (trend breakdown), coins (member coins), sentiment.

  • get_coin_historicalFree

    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…".

  • get_coin_riskFree

    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".

  • get_coin_sentimentFree

    On-chain/social sentiment aggregates for a single coin.

  • get_funding_alertsFree

    Discrete funding-rate alert events (asset, trigger zone, funding at trigger, fired-at time).

  • get_funding_momentumFree

    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.

  • get_futures_signalsFree

    Perpetual-futures signal engine. view=state (currently open signals), log (recent fires), history (one asset's past signals — needs asset).

  • get_global_marketFree

    Global market aggregates: BTC dominance, total market cap, total volume.

  • get_holdersFree

    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?".

  • get_market_crossingFree

    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.

  • get_market_healthFree

    Overall market health: the UP/HODL/DOWN trend distribution and extreme movers. Set context for the full bundle.

  • get_market_sentimentFree

    Aggregate market sentiment. view=market/latest/summary (overall), narratives, categories, slopes/entity-slopes (what is trending), health (pipeline status).

  • get_narrativeFree

    Sentiment and momentum for a single named narrative.

  • get_pair_suggestionsFree

    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).

  • get_pricesFree

    Bulk live prices, optionally with 4h/24h/7d baseline overlays. Omit symbols for the full tracked set.

  • get_regimeFree

    Market regime signals. view=active (current positions), signals (all), confidence (scores). Provide symbol to get that symbol's regime history instead.

  • get_rwa_assetFree

    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.

  • get_signalFree

    Synthesized verdict for a coin, combining trend, funding, sentiment and regime.

  • get_signal_qualityFree

    Signal validation envelope for an asset: Sharpe ratio, win rate, sample size, reliability tier.

  • get_transcriptsFree

    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?".

  • get_walletsFree

    Tracked wallets. view=watchlist (which wallets are tracked), movements (recent balance changes for one wallet address). Answers "what did this wallet do recently?".

  • list_categoriesFree

    List all tracked crypto categories (DeFi, Layer 2, memes, …).

  • list_narrativesFree

    List the currently active market narratives (e.g. "AI coins", "DeFi summer").

  • list_rwa_assetsFree

    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?".

  • lookup_coinFree

    Look up a single coin and its core metrics (price, trend, metadata) by symbol, name, CoinGecko/internal id, or on-chain contract address.

  • resolve_coinFree

    Fuzzily resolve a symbol, name, or contract to canonical coin candidates. Use this first when the user input is ambiguous, before calling other tools.

  • scan_coinsFree

    Filter the tracked universe by trend direction, category, market-cap band, and exchange.

  • scan_trendsFree

    Trend scanner. state=fresh (newly started), stale (longest running), aligned (multi-timeframe agreement), extreme (biggest moves), historical.

  • search_webFree

    Search the web for crypto information, or get a direct answer. Backed by Shumi's web-search tool.

Public scan report

scanner v0.1.9 · 2026-09-21 · same rubric, same numbers if you re-run it

no findings
  • Code scan14 source files scanned25/25
  • Live reliabilityremote reachable in 587ms20/20
  • Tool poisoning31 tool descriptions checked15/15
  • Auth qualityopen endpoint, read-only tools10/15
  • Maintenancelast push 4 days ago15/15
  • Maintainer identitynamespace and repository owner differ; website matches verified namespace6/10
Overall 91/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

What the publisher says

From the MCP 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:http

Each 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.

Install directly

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

MCP: common questions

Is MCP server safe?
Yes, by our scan: it is graded A (91/100). Read the MCP safety report
How do I install MCP?
It runs remotely at mcp.shumi.ai. Add it to Claude Code, Claude Desktop or Cursor with the snippets above, or call it through the mcp.market gateway without installing anything.
Does MCP need an API key?
Yes. The registry entry asks for SHUMI_TOKEN.
Is MCP maintained?
The last commit was 4 days ago (2026-09-17). The latest release is v1.1.1.
Is MCP up?
100% of our last 8 checks got an answer. We check remote servers about four times a day.
What can I use instead of MCP?
Servers from other publishers that do the same job: Blockrun MCP server, Daepak Market Intelligence MCP server and AgentServices MCP server. Compare all MCP alternatives.

Alternatives to MCP

Same job from other publishers: the closest match first, then the best rated.

All MCP alternatives →
  • Blockrun
    Web search, deep research, prediction markets & crypto data for AI agents. Pay per call via x402.
    B
  • Daepak Market Intelligence
    Market analyst tools + AI agent: crypto, US equities, options, Korea, fundamentals, macro, backtests
    C
  • AgentServices
    52 paid x402 API endpoints for AI agents — crypto, data, DeFi, market intelligence.
    A
  • CoinCryptoRank MCP
    Real-time crypto market data, funding rates, arbitrage and trading tools from 60+ exchanges.
    B
  • Losbeto
    x402-paid market intelligence: forex, stocks, Brazil macro (BCB/B3) + crypto.
    A
MCP vs BlockrunMCP vs Daepak Market IntelligenceMCP vs AgentServices

More from shumi.ai →