Bitculator
Bitculator MCP Server

Живые криптоданные для вашего ИИ-ассистента

MCP-сервер Bitculator открывает Data API как 19 отобранных инструментов «только для чтения» по открытому Model Context Protocol. Подключитесь один раз — и ассистент отвечает живыми ценами, историей, настроениями и данными о биржах.

Эндпоинт
https://bitculator.com/mcp
Транспорт
Streamable HTTP
Аутентификация
Bearer API-ключ
Инструменты
19 · только для чтения

MCP (Model Context Protocol) — открытый стандарт, через который ИИ-клиенты обращаются к внешним инструментам. Любой клиент с поддержкой удалённых серверов по Streamable HTTP может использовать Bitculator — популярные разобраны в разделах ниже. Все цены, курсы, капитализации и объёмы предложения возвращаются как decimal strings для сохранения точности — ровно как в REST API.

Аутентификация

Сервер аутентифицируется теми же ключами, что и Data API: создайте ключ с правом data-api в консоли разработчика (подойдёт бесплатный тариф — карта не нужна) и отправляйте его как заголовок Bearer в каждом запросе. Embed-ключи отклоняются.

HTTP-заголовок
Authorization: Bearer YOUR_API_KEY

Запросы без действительного ключа получают 401 unauthenticated. Ключи — это секреты: настраивайте их в параметрах клиента или в переменной окружения и никогда — в общих файлах, которые вы коммитите.

Claude Code

Одна команда регистрирует сервер для вашего проекта (или добавьте --scope user, чтобы он был доступен везде). Claude сам выбирает нужный инструмент, когда вы спрашиваете о рынке.

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

Cursor

Добавьте сервер в ~/.cursor/mcp.json (глобально) или в .cursor/mcp.json внутри проекта. Инструменты появятся в агенте Cursor сразу после сохранения файла.

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

VS Code

Добавьте сервер в .vscode/mcp.json в вашем рабочем пространстве. Агентный режим GitHub Copilot автоматически покажет инструменты Bitculator.

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

Claude API

Строите собственное приложение на Anthropic API? MCP-коннектор обращается к серверу прямо из вызова Messages API — передайте ваш ключ Bitculator как 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 подключается к удалённым MCP-серверам через режим разработчика:

  1. Включите режим разработчика в настройках ChatGPT (Apps & Connectors → Advanced).
  2. Добавьте коннектор с URL сервера https://bitculator.com/mcp.
  3. Аутентификация коннекторов ChatGPT основана на OAuth — заголовки с API-ключом там пока не поддерживаются, поэтому используйте клиент, умеющий работать без авторизации, или поверхности Claude для доступа по ключу.

OAuth-поток (а с ним и полная поддержка каталогов ChatGPT и Claude) — в дорожной карте. Клиенты с ключами — Claude Code, Cursor, VS Code, Claude API — работают уже сегодня.

Квота и лимиты

MCP — это поверхность потребления Data API: отдельного счёта или пула для MCP нет.

  • Каждый вызов инструмента считается одним запросом Data API в счёт месячной квоты вашего тарифа.
  • Минутный лимит вашего тарифа применяется к каждому вызову инструмента (Free 30, Starter 60, Pro 120).
  • При превышении квоты инструменты возвращают ошибку rate_limited, сообщающую ассистенту, когда пул сбросится. Эндпоинты, закрытые тарифом, возвращают plan_required.
  • Протокольное рукопожатие (initialize, tools/list) бесплатно — из пула расходуются только вызовы инструментов.

Агентные фреймворки

Создаёте собственного агента? Все крупные фреймворки включают MCP-клиент, подключающийся по Streamable HTTP с заголовком Bearer - сниппеты ниже загружают все 19 инструментов как нативные функции.

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)

Справочник инструментов

Все 19 инструментов — только для чтения. Параметры повторяют соответствующие эндпоинты Data API — та же валидация, те же тарифные ограничения, та же точность десятичных строк.

Рыночные данные

Инструмент

search_coins

Находит монету или токен по свободному текстовому имени или символу и возвращает канонический slug с ранжированной рыночной сводкой по каждому совпадению. Точка входа: все остальные инструменты по монетам адресуются по slug.

Параметр Тип Описание
query обязательный string Свободный текстовый поиск по названиям и символам монет.
type enum Ограничить совпадения: coin или token.
limit integer Максимум совпадений в ответе (1–50, по умолчанию 10).
Инструмент

get_coin

Полный профиль одной монеты: предложение, ранг и его изменения, исторические максимум/минимум и удалённость от них, полностью разводнённая оценка, ссылки, контракты и описание.

Параметр Тип Описание
slug обязательный string Канонический slug монеты, например bitcoin.
Инструмент

get_prices

Текущие спотовые цены до 100 монет одним вызовом, при желании — с конвертацией в фиатную валюту. Самый дешёвый способ ответить на вопрос о цене: требуется ровно один селектор.

Параметр Тип Описание
slugs string Slug монет через запятую — предпочтительный селектор.
symbols string Тикеры через запятую; неоднозначные символы сопоставляются с монетой с наивысшим рангом.
ids string Числовые id монет Bitculator через запятую.
convert string Символ фиатной валюты для конвертации цен, например EUR. По умолчанию USD.
Инструмент

get_top_movers

Крупнейшие лидеры роста или падения по процентному изменению за последние 24 часа или 7 дней.

Параметр Тип Описание
direction обязательный enum gainers или losers.
interval enum Окно изменения для ранжирования: 24h или 7d (по умолчанию 24h).
limit integer Максимум монет в ответе (1–50, по умолчанию 10).

История

Инструмент

get_price_history

Свечи OHLCV по монете за диапазон дат. Хранение: минутные ~8 дней, получасовые ~3 месяца, часовые ~6 месяцев, дневные — вся история. Возвращает самые свежие свечи в окне, начиная со старейших.

Параметр Тип Описание
slug обязательный string Канонический slug монеты.
interval enum Интервал свечи: minutely, half-hourly, hourly или daily (по умолчанию daily).
start date Начало окна в формате YYYY-MM-DD; по умолчанию — недавнее окно, подходящее интервалу.
end date Конец окна в формате YYYY-MM-DD; по умолчанию — сейчас.
limit integer Максимум свечей в ответе (1–500, по умолчанию 90).
Инструмент

get_historical_price

Цена одной монеты на одну конкретную дату в прошлом, с откатом до 3 дней, если на точный день данных нет.

Параметр Тип Описание
slug обязательный string Канонический slug монеты.
date обязательный date Дата в формате YYYY-MM-DD (2009-01-01 или позже, не в будущем).
Инструмент

get_global_history

Временной ряд общей капитализации крипторынка или общего объёма. Гранулярность зависит от периода: 24h — получасовая, 7d — часовая, 30d и all — дневная.

Параметр Тип Описание
metric обязательный enum Какой ряд вернуть: marketcap или volume.
period enum Окно: 24h, 7d, 30d или all (по умолчанию 24h).

Настроения и глобальные данные

Инструмент

get_global_market

Срез всего рынка: общая капитализация, общий объём за 24 часа, доминирование BTC/ETH и количество монет/токенов/бирж/пар.

Этот инструмент не принимает параметров.

Инструмент

get_fear_greed

Индекс настроений «Страх и жадность» по всему рынку или по одной монете, если передан slug, включая суб-оценки по интервалам 7d/30d.

Параметр Тип Описание
coin string Необязательный slug монеты для значения по конкретной монете; опустите для общерыночного индекса.
Инструмент

get_altseason_index

Индекс альтсезона — опережают ли альткоины биткоин — с опциональной дневной историей.

Параметр Тип Описание
days integer Сколько дней дневной истории включить (0–365; 0 возвращает только текущее значение).
Инструмент

get_liquidations_summary

Сегодняшние итоги ликвидаций фьючерсов с разбивкой long/short и доминированием. Сразу после дневного переката данные могут быть null.

Этот инструмент не принимает параметров.

Биржи

Инструмент

list_exchanges

Биржи в рейтинге с объёмом за 24 часа, доминированием по объёму и количеством пар/активов. Также сопоставляет названия бирж со slug.

Параметр Тип Описание
type enum Ограничить централизованными (cex) или децентрализованными (dex) биржами.
search string Свободный текстовый поиск по названиям бирж.
sort string Поля сортировки через запятую, префикс "-" для убывания: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets.
limit integer Максимум бирж в ответе (1–50, по умолчанию 10).
Инструмент

get_exchange

Полный профиль одной биржи: ранг, объём и изменения, доминирование, листингованные пары и активы, ссылки.

Параметр Тип Описание
slug обязательный string Канонический slug биржи, например binance-exchange.
Инструмент

get_exchange_trust_score

Рейтинг доверия биржи (0–10) с полной разбивкой по 13 факторам.

Параметр Тип Описание
slug обязательный string Канонический slug биржи.
Инструмент

get_coin_markets

Где торгуется монета: её рынки на биржах с парой, ценой и объёмом за 24 часа, отсортированные по объёму.

Параметр Тип Описание
slug обязательный string Канонический slug монеты.
exchange string Необязательный slug биржи, чтобы ограничить результаты одной площадкой.
instrument enum Ограничить одним типом инструмента: spot, future, option, swap или margin.
limit integer Максимум рынков в ответе (1–50, по умолчанию 10).

Анализ и утилиты

Инструмент

get_coin_technicals

Мультииндикаторный технический срез по монете одним вызовом: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, волатильность и другое — каждый с актуальным состоянием и оценкой.

Параметр Тип Описание
slug обязательный string Канонический slug монеты.
Инструмент

convert_currency

Конвертирует сумму между любыми крипто- и/или фиатными валютами (до 10 целей за вызов) по живым курсам, с полной десятичной точностью.

Параметр Тип Описание
from обязательный string Slug исходной валюты, например bitcoin или united-states-dollar.
to обязательный string Slug целевых валют через запятую, до 10.
amount number Сумма исходной валюты для конвертации (по умолчанию 1).
Инструмент

calculate_dca

Бэктест стратегии усреднения (DCA) на реальной истории цен: всего вложено, накоплено монет, текущая стоимость и прибыль/убыток.

Параметр Тип Описание
slug обязательный string Канонический slug монеты.
amount обязательный number Сумма в USD, покупаемая на каждом интервале.
interval обязательный enum Периодичность покупок: daily, weekly, monthly, quarterly или yearly.
start обязательный date Дата первой покупки в формате YYYY-MM-DD (раньше сегодняшнего дня).
end date Дата последней покупки в формате YYYY-MM-DD; по умолчанию — сегодня.
series boolean Включить серию по каждой покупке (большой вывод — оставляйте false, если не просили).