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.

Related MCP server: Crypto Trader MCP Tool

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.