# cryptocapi [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/Jegoba90/cryptocapi-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 1024  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/cryptocapi

## Description
Análisis de riesgo cripto: cada insight PRO trae el SHA-256 de sus inputs para que lo recalcules.

## Tools
Capabilities this server exposes over MCP:

- **get_insight** — Análisis de un activo con el motor determinista de CryptoCapi. La vista "pulse" no exige pase con una key del plan free. La vista "alpha" trae el análisis profundo con el audit_trail y su protocol_hash, que es el sello del cálculo, y requiere el pase Radar Alpha (o Quant Plus si se pide engine="quant_plus"). Con la key pública de demostración, que es la que se usa si no se configura otra, solo responden bitcoin y ethereum, en cualquier vista, y la respuesta es siempre la alpha: otra moneda da 403 aunque se pida "pulse". Al leer la respuesta: `z_score` mide el MOVIMIENTO del último día cerrado (UTC), no el del día en curso, contra los movimientos pasados, y la posición en Bandas de Bollinger mide el NIVEL de precio contra su rango. Son ejes distintos: precio en el tercio superior con z_score negativo no es una contradicción, es un nivel alto después de un día que cerró con una caída fuerte. No las mezcles en una sola frase. Las stablecoins se leen por la distancia de su último cierre al dólar, no por el z_score. Si la moneda todavía no tiene análisis, la respuesta es `{"status":"success","data":null}`: no es un error ni un fallo de la consulta, es que ningún motor calculó nada para ese activo. Decilo así, «no hay análisis disponible», y no completes el hueco por tu cuenta.
- **get_signal** — Señal cuantitativa para un par de trading. Requiere el pase Quant Pro: ningún otro motor lo habilita. Ojo con el formato, que no es el mismo que en las otras herramientas: acá va el par ("BTCUSDT"), no el identificador de moneda ("bitcoin").
- **batch_signals** — Señales de Quant Plus para varios activos en una sola llamada. Requiere el pase Quant Plus, con una excepción: con la key pública de demostración funciona para bitcoin y ethereum, igual que get_insight. Ojo con el formato: acá van identificadores de moneda ("bitcoin"), no pares de trading, al revés que en get_signal. Solo un universo curado tiene señal, bastante más chico que el conjunto de activos que CryptoCapi sigue: un activo fuera de él vuelve con `available: false`, y eso es la respuesta correcta, no un error.
- **scan_market** — Recorre el mercado y devuelve los activos mejor rankeados según una estrategia. Requiere el pase Market Scan, que se vende aparte de Quant Plus aunque el ranking se arme sobre sus señales. El ranking cubre el universo curado de Quant Plus, bastante más chico que el conjunto de activos que CryptoCapi sigue, así que pedir 50 puede devolver bastante menos. Eso no es un fallo.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "cryptocapi": {
    "command": "npx",
    "args": ["-y","@cryptocapi/mcp"],
    "env": {
      "CRYPTOCAPI_API_KEY": "",
      "CRYPTOCAPI_API_BASE": "",
      "CRYPTOCAPI_TIMEOUT_MS": ""
    }
  }
}
```

**Requires environment variables:** `CRYPTOCAPI_API_KEY`, `CRYPTOCAPI_API_BASE`, `CRYPTOCAPI_TIMEOUT_MS` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What cryptocapi does

The cryptocapi MCP server connects an MCP client to CryptoCapi's market-analysis API. It exposes four tools: `get_insight`, `batch_signals`, `get_signal`, and `scan_market`. `get_insight` supports Radar analysis and can also select the Quant Plus engine; the other tools provide multi-asset signals, pair-level quantitative signals, or market rankings.

Responses from the analysis engines include an `audit_trail` with a `protocol_hash`. The package passes these values through without reserializing them, allowing the hash from an MCP response to be compared with the result of the same request made directly to the REST API. This supports reproducibility checks, but the hash does not prove that an analysis is correct or identify its origin through a cryptographic signature.

## How it works

The cryptocapi MCP server starts locally through `npx -y @cryptocapi/mcp` and communicates with the MCP client over standard input and output. Tool requests are sent to the CryptoCapi API using the configured API key and base URL. The package returns the API response to the agent, preserving the verification fields supplied by the service.

The tools use different input formats. `get_signal` expects a trading pair such as `BTCUSDT`, while `batch_signals` expects coin identifiers such as `bitcoin`. Requests for a single asset use a 20-second timeout budget by default; operations that scan multiple assets use 45 seconds.

## Setup and configuration

Add the following MCP server entry to a compatible client's configuration:

```json
{
  "mcpServers": {
    "cryptocapi": {
      "command": "npx",
      "args": ["-y", "@cryptocapi/mcp"]
    }
  }
}
```

No environment variable is required for the public demonstration mode. The package falls back to `demo_btc_eth_public`, which supports limited Bitcoin and Ethereum requests. Set `CRYPTOCAPI_API_KEY` to use another key. `CRYPTOCAPI_API_BASE` changes the API endpoint and defaults to `https://api.cryptocapi.com/v1`; `CRYPTOCAPI_TIMEOUT_MS` sets the request budget when a custom value is needed.

A free 14-day trial from CryptoCapi opens all four engines without the demo asset restriction. API access is separated by pass: Radar Alpha, Quant Plus, Quant Pro, and Market Scan are independent entitlements.

## Tools and capabilities

- `get_insight`: returns an asset analysis through Radar. The `alpha` view includes the verification seal; `pulse` and `alpha` have different access requirements.
- `get_insight` with `engine="quant_plus"`: returns deterministic Quant Plus analysis with a reproducibility seal and `input_vector`.
- `batch_signals`: returns Quant Plus signals for multiple assets in one request.
- `get_signal`: returns a Quant Pro signal for a trading pair.
- `scan_market`: ranks the market according to a Market Scan strategy.

The demo key allows `get_insight` and Quant Plus requests only for Bitcoin and Ethereum. Quant Pro and Market Scan remain unavailable with that key, regardless of the requested asset or pair.

## Limitations and notes

The cryptocapi MCP server does not expose the former third-party data tools for market summaries, CoinGecko prices, or FRED macro series. Those endpoints remain in the REST API but are not presented as MCP tools because the product focuses on derived intelligence from its own engines.

Each engine requires its own pass, and access to one engine does not unlock another. The protocol hash checks reproducibility and data integrity, not analytical accuracy. The npm package also documents CI-based provenance and recommends `npm audit signatures` for checking package signatures.

_Full upstream README: https://allmcps.com/mcp/cryptocapi/readme_