Back to Browse

Coinintel MCP Server

Developer ToolsModerate5.8MCP RegistryLocal
Free

Server data from the Official MCP Registry

Crypto market intelligence: prices, sentiment, risk, narratives, funding and signals.

About

Crypto market intelligence: prices, sentiment, risk, narratives, funding and signals.

Security Report

5.8
Moderate5.8Moderate Risk

coinintel is a read-only crypto market-data wrapper that requires SHUMI_TOKEN, sends it only as the x-api-key header, and uses no shell execution or dynamic code evaluation. The main concerns are low-severity: the API base URL is user-overridable and defaults to an unverified reconstructed domain, so the API key would be sent wherever that URL points, and the npm scope does not match the repository owner. Permissions (network_http, env_vars) match the stated purpose. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

8 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

SHUMI_TOKENRequired

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "coinintel": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/coinintel@0.1.0"
      ],
      "env": {
        "SHUMI_TOKEN": "your-shumi-token-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

coinintel

coinintel wraps a read-only crypto market-intelligence API: finding and resolving coins, current prices and history, per-coin sentiment, risk and signals, market-wide health, sentiment and regime reads, trend and coin scans, narratives, categories, and funding momentum and alerts. One binary serves a command-line interface and a stdio MCP server.

An API key is required. Set SHUMI_TOKEN before use; when it is missing or blank, every tool fails with an error naming SHUMI_TOKEN before any request is made. The key is sent as the x-api-key header. The API base URL can be overridden with SHUMI_API_URL; when it is not set, calls go to https://api.shumi.ai (a reconstruction — the upstream README does not publish a base URL).

List-returning tools share a convention: top (an integer) keeps only the first N entries, and fields (a comma-separated list of names) keeps only those fields on each entry. Both are sent to the API, and the same trimming is applied to array responses locally.

This build is a labelled core subset: 20 read-only tools. The upstream tool set also documents signal-quality, pair suggestions, real-world-asset, unlock, holder, wallet, futures, basket, transcript, question-answering, and web-search tools; those are not part of this subset.

Install

npx @reneturcios/coinintel get_regime

Or run the container image:

docker run -i ghcr.io/cloudcorprecords/coinintel

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

The subcommands mirror the MCP tool names:

export SHUMI_TOKEN=...

coinintel lookup_coin --query bitcoin
coinintel resolve_coin --query ether
coinintel get_prices --symbols BTC,ETH --top 2 --fields symbol,price
coinintel get_coin_historical --coin BTC --range 30d
coinintel get_coin_sentiment --coin BTC
coinintel get_coin_risk --coin BTC
coinintel get_global_market
coinintel get_market_health --top 5
coinintel scan_trends
coinintel scan_coins --fields symbol,score
coinintel list_narratives
coinintel get_narrative --narrative "ai tokens"
coinintel list_categories
coinintel get_category --category defi
coinintel get_funding_momentum
coinintel get_funding_alerts
coinintel get_regime
coinintel get_signal --coin BTC

coinintel --version

Results print the upstream JSON payload. Exit codes: 0 on success, 1 when a call fails (including a missing token or an upstream API error), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

npx -y @reneturcios/coinintel mcp

MCP client configuration:

{
  "mcpServers": {
    "coinintel": {
      "command": "npx",
      "args": ["-y", "@reneturcios/coinintel", "mcp"],
      "env": { "SHUMI_TOKEN": "..." }
    }
  }
}

Tools

ToolInputWhat it does
lookup_coinquery (required)Look up coins matching a free-text query.
resolve_coinquery (required)Resolve a query to a single canonical coin.
get_pricessymbols (required array), top, fieldsGet current prices for symbols.
get_coin_historicalcoin (required), range, top, fieldsGet historical data for a coin.
get_coin_sentimentcoin (required), top, fieldsGet sentiment data for a coin.
get_coin_riskcoin (required)Get the risk assessment for a coin.
get_global_markettop, fieldsGet global market overview data.
get_market_healthtop, fieldsGet market health indicators.
get_market_sentimenttop, fieldsGet aggregate market sentiment.
get_market_crossingtop, fieldsGet market crossing signals.
scan_trendstop, fieldsScan for current market trends.
scan_coinstop, fieldsScan coins against market criteria.
list_narrativestop, fieldsList market narratives.
get_narrativenarrative (required)Get a single market narrative.
list_categoriestop, fieldsList coin categories.
get_categorycategory (required)Get a single coin category.
get_funding_momentumtop, fieldsGet funding-rate momentum data.
get_funding_alertstop, fieldsGet funding-rate alerts.
get_regime(none)Get the current market regime.
get_signalcoin (required)Get the trading signal for a coin.

Development

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.

Reviews

No reviews yet

Be the first to review this server!