Coinintel

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 bitcoincoinintel resolve_coin --query ethercoinintel get_prices --symbols BTC,ETH --top 2 --fields symbol,pricecoinintel get_coin_historical --coin BTC --range 30dcoinintel get_coin_sentiment --coin BTCcoinintel get_coin_risk --coin BTCcoinintel get_global_marketcoinintel get_market_health --top 5coinintel scan_trendscoinintel scan_coins --fields symbol,scorecoinintel list_narrativescoinintel get_narrative --narrative "ai tokens"coinintel list_categoriescoinintel get_category --category deficoinintel get_funding_momentumcoinintel get_funding_alertscoinintel get_regimecoinintel 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 installnpm 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.