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, якщо не просили).