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.

Related MCP server: artemis-mcp

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

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.