Cryptoprice

cryptoprice

cryptoprice reads public cryptocurrency data from CoinGecko: whether the API is up, what coins cost right now, the full record for a single coin, the complete coin list, search across coins and exchanges, historical market charts, the global market picture, and what is trending. One binary serves a command-line interface and a stdio MCP server.

No API key is needed. CoinGecko's free tier is keyless, so cryptoprice works with nothing configured. If you do have a demo key, set COINGECKO_API_KEY and it will be sent as the x-cg-demo-api-key header; when the variable is absent or empty, no key header is sent and nothing fails for lack of a key. Free-tier rate limits apply to upstream calls.

Install

npx @reneturcios/cryptoprice ping

Or run the container image:

docker run -i ghcr.io/cloudcorprecords/cryptoprice

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

CLI

cryptoprice ping

cryptoprice price bitcoin,ethereum usd,eur --change cryptoprice coin bitcoin cryptoprice coins --platform cryptoprice search "wrapped bitcoin" cryptoprice chart ethereum eur 30 cryptoprice global cryptoprice trending

cryptoprice --version

Each command prints the upstream JSON payload. Exit codes: 0 on success, 1 when a call fails (including an upstream API error such as a rate limit), 2 for usage errors.

MCP server

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

npx -y @reneturcios/cryptoprice mcp

MCP client configuration:

{

"mcpServers": { "cryptoprice": { "command": "npx", "args": ["-y", "@reneturcios/cryptoprice", "mcp"] } } }

Tools

All calls use the CoinGecko API under https://api.coingecko.com/api/v3. Identifiers such as ids and id are CoinGecko IDs (for example bitcoin), not symbols.

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.