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