Bitculator
Servidor MCP de Bitculator

Datos cripto en vivo para tu asistente de IA

El servidor MCP de Bitculator expone la Data API como 19 herramientas seleccionadas y de solo lectura sobre el Model Context Protocol abierto. Conéctalo una vez y tu asistente responderá con precios en vivo, histórico, sentimiento e inteligencia de exchanges.

Endpoint
https://bitculator.com/mcp
Transporte
Streamable HTTP
Autenticación
Clave de API Bearer
Herramientas
19 · solo lectura

MCP (Model Context Protocol) es el estándar abierto que los clientes de IA usan para llegar a herramientas externas. Cualquier cliente que soporte servidores remotos sobre Streamable HTTP puede usar Bitculator - las secciones de abajo cubren los más populares. Todos los precios, tasas, capitalizaciones y ofertas se devuelven como cadenas decimales para preservar la precisión, exactamente igual que la API REST.

Autenticación

El servidor se autentica con las mismas claves que la Data API: crea una clave con la habilidad data-api en la consola de desarrollador (el plan gratuito sirve - sin tarjeta) y envíala como cabecera Bearer en cada solicitud. Las claves de embed se rechazan.

Cabecera HTTP
Authorization: Bearer YOUR_API_KEY

Las solicitudes sin una clave válida reciben 401 unauthenticated. Las claves son secretos - configúralas en los ajustes de tu cliente o en una variable de entorno, nunca en archivos compartidos que subas al repositorio.

Claude Code

Un solo comando registra el servidor para tu proyecto (o añade --scope user para tenerlo disponible en todas partes). Claude elige la herramienta correcta automáticamente cuando preguntas por el mercado.

terminal
claude mcp add --transport http bitculator \
    https://bitculator.com/mcp \
    --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Añade el servidor a ~/.cursor/mcp.json (global) o a .cursor/mcp.json dentro de un proyecto. Las herramientas aparecen en el agente de Cursor en cuanto se guarda el archivo.

~/.cursor/mcp.json
{
  "mcpServers": {
    "bitculator": {
      "url": "https://bitculator.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code

Añade el servidor a .vscode/mcp.json en tu espacio de trabajo. El modo agente de GitHub Copilot lista las herramientas de Bitculator automáticamente.

.vscode/mcp.json
{
  "servers": {
    "bitculator": {
      "type": "http",
      "url": "https://bitculator.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude API

¿Construyes tu propia app sobre la API de Anthropic? El conector MCP llega al servidor directamente desde una llamada a la Messages API - pasa tu clave de Bitculator como authorization_token.

POST /v1/messages
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 1024,
    "mcp_servers": [{
      "type": "url",
      "url": "https://bitculator.com/mcp",
      "name": "bitculator",
      "authorization_token": "YOUR_API_KEY"
    }],
    "tools": [{ "type": "mcp_toolset", "mcp_server_name": "bitculator" }],
    "messages": [{ "role": "user", "content": "How is the crypto market today?" }]
  }'

ChatGPT

ChatGPT se conecta a servidores MCP remotos a través del modo desarrollador:

  1. Activa el modo desarrollador en los ajustes de ChatGPT (Apps & Connectors → Advanced).
  2. Añade un conector con la URL del servidor https://bitculator.com/mcp.
  3. La autenticación de conectores de ChatGPT se basa en OAuth - las cabeceras de clave de API aún no se soportan allí, así que usa un cliente capaz de funcionar sin autenticación o las superficies de Claude para el acceso por clave.

Un flujo OAuth (y con él el soporte completo de los directorios de ChatGPT y Claude) está en la hoja de ruta. Los clientes basados en clave - Claude Code, Cursor, VS Code, la Claude API - funcionan hoy.

Cuota y límites

MCP es una superficie de consumo de la Data API - no hay factura ni fondo MCP aparte.

  • Cada llamada a herramienta cuenta como una solicitud a la Data API contra la cuota mensual de tu plan.
  • El límite de ráfaga por minuto de tu plan se aplica por llamada a herramienta (Free 30, Starter 60, Pro 120).
  • Por encima de la cuota, las herramientas devuelven un error rate_limited que indica al asistente cuándo se reinicia el fondo. Los endpoints restringidos por plan devuelven plan_required.
  • El apretón de manos del protocolo (initialize, tools/list) es gratuito - solo las llamadas a herramientas consumen del fondo.

Frameworks de agentes

¿Construyes tu propio agente? Todos los frameworks principales incluyen un cliente MCP que se conecta por Streamable HTTP con una cabecera Bearer - los fragmentos de abajo cargan las 19 herramientas como funciones nativas.

OpenAI Agents SDK

pip install openai-agents
Python
from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    name="Bitculator",
    params={"url": "https://bitculator.com/mcp",
            "headers": {"Authorization": "Bearer YOUR_API_KEY"}},
) as server:
    agent = Agent(name="analyst", mcp_servers=[server])

Vercel AI SDK

npm i @ai-sdk/mcp
TypeScript
import { createMCPClient } from '@ai-sdk/mcp';

const mcp = await createMCPClient({
  transport: {
    type: 'http',
    url: 'https://bitculator.com/mcp',
    headers: { Authorization: 'Bearer YOUR_API_KEY' },
  },
});
const tools = await mcp.tools();

LangChain

pip install langchain-mcp-adapters
Python
from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({"bitculator": {
    "transport": "http",
    "url": "https://bitculator.com/mcp",
    "headers": {"Authorization": "Bearer YOUR_API_KEY"},
}})
tools = await client.get_tools()

LlamaIndex

pip install llama-index-tools-mcp
Python
from llama_index.tools.mcp import BasicMCPClient, McpToolSpec

client = BasicMCPClient("https://bitculator.com/mcp",
                        headers={"Authorization": "Bearer YOUR_API_KEY"})
tools = await McpToolSpec(client=client).to_tool_list_async()

Mastra

npm i @mastra/mcp
TypeScript
import { MCPClient } from '@mastra/mcp';

const mcp = new MCPClient({ servers: { bitculator: {
    url: new URL('https://bitculator.com/mcp'),
    requestInit: { headers: { Authorization: 'Bearer YOUR_API_KEY' } },
}}});
const tools = await mcp.getTools();

Semantic Kernel

pip install semantic-kernel[mcp]
Python
from semantic_kernel.connectors.mcp import MCPStreamableHttpPlugin

async with MCPStreamableHttpPlugin(
    name="Bitculator",
    url="https://bitculator.com/mcp",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
) as plugin:
    kernel.add_plugin(plugin)

Referencia de herramientas

Las 19 herramientas son de solo lectura. Los parámetros reflejan los endpoints correspondientes de la Data API - misma validación, mismas restricciones de plan, misma precisión de cadenas decimales.

Datos de mercado

Herramienta

search_coins

Resuelve una coin o token por nombre en texto libre o símbolo a su slug canónico, con un resumen de mercado clasificado por coincidencia. El punto de entrada: todas las demás herramientas de coins se direccionan por slug.

Parámetro Tipo Descripción
query obligatorio string Búsqueda en texto libre comparada con nombres y símbolos de coins.
type enum Restringe las coincidencias: coin o token.
limit integer Máximo de coincidencias a devolver (1–50, por defecto 10).
Herramienta

get_coin

Perfil completo de una coin: ofertas, rango y cambios de rango, máximo/mínimo históricos y distancia hasta ellos, valoración totalmente diluida, enlaces, contratos y descripción.

Parámetro Tipo Descripción
slug obligatorio string Slug canónico de la coin, p. ej. bitcoin.
Herramienta

get_prices

Precios spot actuales de hasta 100 coins en una llamada, opcionalmente convertidos a una divisa fiat. La forma más barata de responder preguntas de precios - se requiere exactamente un selector.

Parámetro Tipo Descripción
slugs string Slugs de coins separados por comas - el selector preferido.
symbols string Símbolos ticker separados por comas; los símbolos ambiguos se resuelven a la coincidencia mejor clasificada.
ids string Ids numéricos de coins de Bitculator separados por comas.
convert string Símbolo de la divisa fiat a la que convertir los precios, p. ej. EUR. Por defecto USD.
Herramienta

get_top_movers

Las mayores subidas o bajadas por cambio porcentual en las últimas 24 horas o 7 días.

Parámetro Tipo Descripción
direction obligatorio enum gainers o losers.
interval enum Ventana de cambio para clasificar: 24h o 7d (por defecto 24h).
limit integer Máximo de coins a devolver (1–50, por defecto 10).

Histórico

Herramienta

get_price_history

Velas OHLCV de una coin en un rango de fechas. Retención: por minuto ~8 días, por media hora ~3 meses, por hora ~6 meses, diario = histórico completo. Devuelve las velas más recientes de la ventana, las más antiguas primero.

Parámetro Tipo Descripción
slug obligatorio string Slug canónico de la coin.
interval enum Intervalo de las velas: minutely, half-hourly, hourly o daily (por defecto daily).
start date Inicio de la ventana como YYYY-MM-DD; por defecto una ventana reciente adecuada al intervalo.
end date Fin de la ventana como YYYY-MM-DD; por defecto ahora.
limit integer Máximo de velas a devolver (1–500, por defecto 90).
Herramienta

get_historical_price

El precio de una coin en una fecha pasada concreta, con hasta 3 días de respaldo cuando el día exacto no tiene datos.

Parámetro Tipo Descripción
slug obligatorio string Slug canónico de la coin.
date obligatorio date La fecha como YYYY-MM-DD (2009-01-01 o posterior, no en el futuro).
Herramienta

get_global_history

Serie temporal de la capitalización total del mercado cripto o del volumen total. La granularidad sigue el periodo: 24h por media hora, 7d por hora, 30d y all a diario.

Parámetro Tipo Descripción
metric obligatorio enum Qué serie devolver: marketcap o volume.
period enum Ventana: 24h, 7d, 30d o all (por defecto 24h).

Sentimiento y global

Herramienta

get_global_market

Instantánea de todo el mercado: capitalización total, volumen total de 24 h, dominancia de BTC/ETH y recuentos de coins/tokens/exchanges/pares.

Esta herramienta no acepta parámetros.

Herramienta

get_fear_greed

El índice de sentimiento de Miedo y Codicia para todo el mercado, o para una coin cuando se pasa un slug, incluyendo subpuntuaciones por intervalo de 7d/30d.

Parámetro Tipo Descripción
coin string Slug de coin opcional para una lectura por coin; omítelo para el índice de todo el mercado.
Herramienta

get_altseason_index

El índice de altseason - si las altcoins están superando a Bitcoin - con histórico diario opcional.

Parámetro Tipo Descripción
days integer Días de histórico diario a incluir (0–365; 0 devuelve solo la lectura actual).
Herramienta

get_liquidations_summary

Los totales de liquidaciones de futuros de hoy con el reparto largo/corto y la dominancia. Los datos pueden ser null justo después del cierre diario.

Esta herramienta no acepta parámetros.

Exchanges

Herramienta

list_exchanges

Exchanges clasificados con volumen de 24 h, dominancia de volumen y recuentos de pares/activos. También resuelve nombres de exchanges a slugs.

Parámetro Tipo Descripción
type enum Restringe a exchanges centralizados (cex) o descentralizados (dex).
search string Búsqueda en texto libre comparada con nombres de exchanges.
sort string Campos de ordenación separados por comas, prefijo "-" para descendente: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets.
limit integer Máximo de exchanges a devolver (1–50, por defecto 10).
Herramienta

get_exchange

Perfil completo de un exchange: rango, volumen y cambios, dominancia, pares y activos listados, y enlaces.

Parámetro Tipo Descripción
slug obligatorio string Slug canónico del exchange, p. ej. binance-exchange.
Herramienta

get_exchange_trust_score

La puntuación de confianza de un exchange (0–10) con su desglose completo de 13 factores.

Parámetro Tipo Descripción
slug obligatorio string Slug canónico del exchange.
Herramienta

get_coin_markets

Dónde cotiza una coin: sus mercados en los distintos exchanges con par, precio y volumen de 24 h, ordenados por volumen.

Parámetro Tipo Descripción
slug obligatorio string Slug canónico de la coin.
exchange string Slug de exchange opcional para restringir los resultados a una sola plataforma.
instrument enum Restringe a un tipo de instrumento: spot, future, option, swap o margin.
limit integer Máximo de mercados a devolver (1–50, por defecto 10).

Análisis y utilidades

Herramienta

get_coin_technicals

La instantánea técnica multiindicador de una coin en una llamada: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilidad y más, cada uno con su último estado y puntuación.

Parámetro Tipo Descripción
slug obligatorio string Slug canónico de la coin.
Herramienta

convert_currency

Convierte un importe entre cualesquiera divisas cripto y/o fiat (hasta 10 destinos por llamada) usando tasas en vivo, con precisión decimal completa.

Parámetro Tipo Descripción
from obligatorio string Slug de la divisa de origen, p. ej. bitcoin o united-states-dollar.
to obligatorio string Slugs de las divisas de destino separados por comas, hasta 10.
amount number Importe de la divisa de origen a convertir (por defecto 1).
Herramienta

calculate_dca

Backtestea una estrategia de promediado de coste (DCA) contra el histórico de precios real: total invertido, coins acumuladas, valor actual y ganancias/pérdidas.

Parámetro Tipo Descripción
slug obligatorio string Slug canónico de la coin.
amount obligatorio number Importe en USD comprado en cada intervalo.
interval obligatorio enum Cadencia de compra: daily, weekly, monthly, quarterly o yearly.
start obligatorio date Fecha de la primera compra como YYYY-MM-DD (antes de hoy).
end date Fecha de la última compra como YYYY-MM-DD; por defecto hoy.
series boolean Incluir la serie compra a compra (salida voluminosa - déjalo en false salvo que se pida).