# Shumi

> Shumi is a freemium MCP server for finance and payments. Read-only crypto market data for agents: prices, funding, narratives, regime and pairs. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web, Telegram
- **Website:** https://shumi.ai
- **Repository:** https://github.com/shumi-ai/shumi-mcp
- **MCP Registry name:** ai.shumi/mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-21

## About

A thin wrapper over the Shumi data API, built on CoinRotator, for Claude, Cursor and other MCP clients. It needs a Shumi API key and every tool is read-only. Over 30 typed tools cover coin risk, prices, trend scans, sentiment, funding momentum and alerts, market regime, token unlocks, holders and wallets, pair and delta-neutral suggestions, and transcript highlights.

Two free-form tools sit alongside them: `ask_shumi` takes a natural-language question and `search_web` searches the web. Real-world assets such as stocks, ETFs, commodities and FX, traded as perps on Hyperliquid builder DEXes, have their own tools and are not found by the coin tools. List tools accept `top` and `fields` to trim token use.

Run it locally with npx over stdio, or use the hosted endpoint at mcp.shumi.ai. Free, access and pro tiers are enforced server-side, and out-of-quota responses come back with a hint. The company's studies page publishes back-tested setups with their risks.

## Features

- **Typed market tools:** Deterministic tools for prices, trends, sentiment, funding and regime.
- **Natural-language query:** ask_shumi classifies a question, fetches data and synthesises an answer.
- **Real-world assets:** Separate tools for stocks, ETFs, commodities, indices and FX perps.
- **Unlocks and holders:** Token unlock calendars plus holder and wallet tracking.
- **Pair ideas:** Suggests pair and delta-neutral research ideas.
- **Token-saving options:** top and fields parameters trim list results.
- **Hosted or local:** Run via npx over stdio or connect to the remote endpoint.

## Good for

- Check funding and trend for a coin before sizing a position
- Scan which sectors or narratives are gaining attention
- Look up upcoming token unlocks
- Get a regime read on the broader market
- Research delta-neutral pair ideas

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.shumi.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.shumi.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.shumi.ai/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.shumi.ai/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp.shumi.ai/mcp
```

Enter a Name (for example "Shumi"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.shumi.ai/mcp"
    }
  }
}
```

## Tools

- `get_coin_risk`: Coin risk read.
- `get_market_health`: Market health overview.
- `ask_shumi`: Natural-language question answered by classifying, fetching and synthesising.
- `search_web`: Web search.
- `get_prices`: Prices.
- `scan_trends`: Trend scan.
- `get_funding_momentum`: Funding momentum.
- `get_regime`: Market regime.
- `get_pair_suggestions`: Pair and delta-neutral ideas.
- `get_unlocks`: Token unlocks.
- `list_rwa_assets`: Lists real-world asset perps.

## FAQ

### Do I need an API key?

Yes, a shumi_sk_ key created from the Shumi site or CLI.

### Can Shumi place trades?

The README says all tools are read-only.

### What does the service cost?

There is a free tier with a few queries, then a daily free query; Plus allows 50 queries a day, Pro is unlimited and Genesis is a one-time $500 lifetime Pro grant.

### How do I install Shumi?

Add npx -y @shumi-ai/mcp with SHUMI_TOKEN set, or use the remote server at https://mcp.shumi.ai/mcp.

### How do I add Shumi to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.shumi.ai/mcp

### What are the best alternatives to Shumi?

The closest alternatives to Shumi are blockchainacademics.com, Bitculator, Real-Time Market Quotes, News & Social Sentiment MCP, MarketTrace Crypto MCP and Cockpit.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [blockchainacademics.com](https://ai-powered.com/mcp/blockchainacademics-com): blockchainacademics.com is a freemium MCP server for finance and payments.
- [Bitculator](https://ai-powered.com/mcp/bitculator): Bitculator is a freemium MCP server for finance and payments.
- [Real-Time Market Quotes, News & Social Sentiment MCP](https://ai-powered.com/mcp/real-time-market-quotes-news-and-social-sentiment-mcp): Real-Time Market Quotes, News & Social Sentiment MCP is a freemium MCP server for finance and payments.
- [MarketTrace Crypto MCP](https://ai-powered.com/mcp/markettrace-crypto-mcp): MarketTrace Crypto MCP is a free MCP server for finance and payments.
- [Cockpit](https://ai-powered.com/mcp/cockpit): Cockpit is a freemium MCP server for finance and payments.
- [ByKaranteli](https://ai-powered.com/mcp/bykaranteli): ByKaranteli is a freemium MCP server for finance and payments.
- [Crypto Market Data](https://ai-powered.com/mcp/crypto-market-data): Crypto Market Data is an open-source MCP server for finance and payments.
- [Bitquery MCP Server](https://ai-powered.com/mcp/bitquery-mcp-server): Bitquery MCP Server is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/shumi
