Довідник інструментів

Конектор Kurslog має одинадцять інструментів і три готові сценарії. Усі інструменти лише читають дані (readOnlyHint: true, openWorldHint: false), мають outputSchema і повертають компактний JSON і текстом, і в structuredContent. Підтримувані версії протоколу MCP: від 2025-03-26 до 2026-07-28, Streamable HTTP без сесій. Назви полів і приклади нижче англійською, як їх бачить Claude.

Спільні аргументи

АргументТипОпис
locale"uk" | "ru" | "en"Мова назв і посилань на kurslog.com. Типово uk; для інших мов en.
from_currency / to_currencyрядокКоди валют з list_currencies, напр. usdt-trc20, bitcoin, monobank-uah, cash-usd.
cityрядокSlug міста для готівки, напр. kyiv; див. find_cities_for_direction.
amountчислоСума у валюті, яку віддаєте. Пропозиції, чиї ліміти її не приймають, не показуються.
statusesмасивСтатуси довіри Kurslog, які лишити: diamond, platinum, gold, silver, new.

find_best_rate

Призначення: Три пропозиції з найвищим курсом для пари, за потреби для міста (готівка) і суми.

Аргументи:

{
  "from_currency": "usdt-trc20",
  "to_currency": "cash-usd",
  "city": "kyiv",                    // for cash-* pairs
  "amount": 2000,                    // in from_currency, optional
  "statuses": ["diamond", "gold"],   // optional trust filter
  "competitive_only": true,          // within 2% of the best rate
  "locale": "en"
}

Приклад відповіді (скорочено):

{
  "direction": {"from_currency": "usdt-trc20", "to_currency": "cash-usd", "city": "kyiv", "amount": 2000},
  "compare_link": "https://kurslog.com/en/usdt-trc20-to-cash-usd-in-kyiv",
  "offers_total": 14, "offers_shown": 3,
  "offers": [
    {"exchanger_name": "Dvizh", "exchanger_slug": "dvizh", "trust_status": "Diamond", "rating": 5.0,
     "rate": 1.02, "rate_inverse": 0.9803921569, "you_receive": 2040.0,
     "min_amount": 490.2, "max_amount": 1000000.0, "reserve": 28623910.13,
     "profile_link": "https://kurslog.com/en/exchanger/dvizh"}
  ],
  "disclaimer": "Rates change continuously and may be a few minutes old. ..."
}

compare_exchangers

Призначення: До 20 пропозицій для пари з тими самими фільтрами, за найкращим курсом (типово) або за надійністю (sort: "trust_score").

Аргументи:

{
  "from_currency": "bitcoin",
  "to_currency": "privatbank-uah",
  "sort": "trust_score",   // or "best_rate"
  "limit": 10,             // 1..20
  "locale": "en"
}

Приклад відповіді (скорочено):

// Same shape as find_best_rate, with up to `limit` offers.

compare_networks

Призначення: Порівнює мережі активу для того самого обміну: найкращий курс і кількість обмінників у кожній мережі, комісію відправки з обраної біржі або власного гаманця, суму на руки, вигоду проти поточної мережі та рекомендацію. Комісії враховуються для USDT і USDC; для готівки потрібне місто.

Аргументи:

{
  "from_currency": "usdt-trc20",   // network the user would send on now
  "to_currency": "cash-usd",
  "city": "kyiv",
  "amount": 500,                   // optional; default 100, 500 for cash
  "send_from": "okx",              // wallet | binance | bybit | okx | bitget | kucoin | whitebit
  "locale": "en"
}

Приклад відповіді (скорочено):

{
  "asset": "USDT", "send_from": "okx", "amount": 500.0, "amount_is_default": false,
  "current_network": "TRC20",
  "recommendation": {"kind": "switch", "network": "ERC20", "gain": 1.18,
                     "summary": "Sending via ERC20 instead of TRC20 gives about 1.18 USD more for 500 USDT."},
  "networks": [
    {"network": "TRC20", "currency": "usdt-trc20", "is_current": true, "is_best": false, "available": true,
     "rate": 1.021, "exchangers": 14, "send_fee": 1.5, "you_receive": 508.97, "compare_link": "..."},
    {"network": "ERC20", "currency": "usdt-erc20", "is_current": false, "is_best": true, "available": true,
     "rate": 1.021, "exchangers": 13, "send_fee": 0.34, "you_receive": 510.15, "gain_vs_current": 1.18,
     "compare_link": "..."}
  ],
  "fees_updated_at": "2026-10-18T21:17:12+00:00",
  "notes": ["Fees are estimates in units of the asset, refreshed every 6 hours: ..."]
}

get_withdrawal_fees

Призначення: Комісії виводу Binance, Bybit, OKX, Bitget, KuCoin і WhiteBIT та вартість відправки з власного гаманця для кожної мережі активу, в одиницях активу.

Аргументи:

{
  "asset": "USDT",       // ticker or any code of the asset, e.g. "usdt-trc20"
  "network": "TON",      // optional
  "locale": "en"
}

Приклад відповіді (скорочено):

{
  "asset": "USDT", "unit": "USDT",
  "sources": {"binance": "Binance", "bybit": "Bybit", "okx": "OKX", "bitget": "Bitget", "whitebit": "WhiteBIT", "kucoin": "KuCoin"},
  "networks": [
    {"network": "TON", "currency": "usdt-ton", "wallet": 0.08,
     "exchanges": {"binance": 0.3, "bitget": 0.15, "kucoin": 0.5, "okx": 0.032, "whitebit": 0.5, "bybit": 0.15},
     "cheapest_exchange": "okx"}
  ],
  "fees_updated_at": "2026-10-18T21:17:12+00:00"
}

get_exchanger_profile

Призначення: Профіль обмінника: статус довіри Kurslog і його підстави, дата заснування, вік домену, сайт, кількість відгуків на моніторингах.

Аргументи:

{"exchanger_slug": "digichanger", "locale": "en"}

Приклад відповіді (скорочено):

{
  "name": "Digichanger", "slug": "digichanger", "status": "active",
  "founding_date": "2023-05-19", "website": "https://www.digichanger.pro",
  "trust": {"status": "diamond", "label": "Diamond",
            "explanation": "Reviews: 3410 reviews across 4 monitoring platforms. On the market: 3 years and 5 months.",
            "domain_age_years": 3.41},
  "reviews_on_monitoring_sites": 3410,
  "kurslog_profile": "https://kurslog.com/en/exchanger/digichanger"
}

get_exchanger_reviews

Призначення: Останні відгуки та скарги на kurslog.com після модерації: оцінка, дата, скорочений текст без імен і посилань, статус скарги, чи відповів обмінник.

Аргументи:

{
  "exchanger_slug": "axocash",
  "review_type": "all",    // all | review | problem
  "limit": 5,              // 1..10
  "locale": "en"
}

Приклад відповіді (скорочено):

{
  "exchanger_slug": "axocash", "review_count": 57, "problem_count": 1,
  "content_note": "User-generated text from kurslog.com, moderated before publishing; ...",
  "reviews": [
    {"type": "review", "rating": 5, "date": "2026-10-09", "language": "uk",
     "text": "I exchange here regularly and am always satisfied. ...", "exchanger_replied": false}
  ],
  "kurslog_reviews_link": "https://kurslog.com/en/exchanger/axocash"
}

find_cities_for_direction

Призначення: Міста з готівковим обміном для пари, з кількістю обмінників і найкращим курсом у кожному. Курси, далекі від медіани, позначені rate_note.

Аргументи:

{"from_currency": "usdt-trc20", "to_currency": "cash-eur", "limit": 15, "locale": "en"}

Приклад відповіді (скорочено):

{
  "direction": {"from_currency": "usdt-trc20", "to_currency": "cash-eur"},
  "count": 15, "median_best_rate": 0.8967,
  "cities": [
    {"city": "Alicante", "slug": "alicante", "exchanger_count": 7, "best_rate": 0.8967,
     "kurslog_link": "https://kurslog.com/en/usdt-trc20-to-cash-eur-in-alicante"}
  ]
}

list_currencies

Призначення: Коди валют для інших інструментів, від найпопулярніших, з тикером і мережею. query фільтрує за кодом, назвою, тикером чи мережею.

Аргументи:

{"query": "ton", "only_with_rates": true, "limit": 200, "locale": "en"}

Приклад відповіді (скорочено):

{
  "count": 3,
  "currencies": [
    {"code": "usdt-ton", "name": "USDT TON", "asset": "USDT", "network": "TON", "tags": ["USDT"]}
  ]
}

find_popular_directions

Призначення: Найпопулярніші напрямки з поточним найкращим курсом загалом, для міста (city) чи країни (country, напр. poland).

Аргументи:

{"city": "warsaw", "limit": 10, "locale": "en"}

Приклад відповіді (скорочено):

{
  "city": "warsaw", "count": 10,
  "directions": [
    {"from_currency": "usdt-trc20", "from_name": "USDT TRC20", "to_currency": "cash-usd", "to_name": "Cash USD",
     "city": "warsaw", "city_name": "Warsaw", "rate": 0.99, "kurslog_link": "..."}
  ]
}

find_alternative_directions

Призначення: Схожі напрямки з активними обмінниками: те саме джерело на інші валюти та інші валюти на ту саму ціль.

Аргументи:

{"from_currency": "usdt-erc20", "to_currency": "monobank-uah", "limit": 5, "locale": "en"}

Приклад відповіді (скорочено):

{
  "direction": {"from_currency": "usdt-erc20", "to_currency": "monobank-uah"},
  "same_source": [{"from_currency": "usdt-erc20", "to_currency": "privatbank-uah", "exchangers": 58, "kurslog_link": "..."}],
  "same_target": [{"from_currency": "usdt-trc20", "to_currency": "monobank-uah", "exchangers": 34, "kurslog_link": "..."}]
}

health_check

Призначення: Стан конектора: версія, доступність даних, час останнього оновлення комісій.

Аргументи:

{}

Приклад відповіді (скорочено):

{"status": "ok", "service": "kurslog-mcp", "version": "2.0.0", "upstream_ok": true,
 "network_fees_updated_at": "2026-10-18T21:17:12+00:00"}

Готові сценарії

  • cash_out_crypto (місто, актив, готівкова валюта, сума)
  • cheapest_network (куди отримати, звідки відправляєте, сума)
  • vet_exchanger (обмінник)

Помилки та порожні результати

На некоректний ввід інструмент повертає результат з isError: true і повідомленням, що змінити: неправильні або невідомі коди валют (з підказками), неправильний slug міста, невідомий обмінник, немає міста для готівкової пари, актив без мереж. Тимчасовий збій даних теж дає isError: true з порадою повторити й не кешується. Коректний запит без пропозицій це звичайний результат із поясненням у message, наприклад що сума поза лімітами обмінників і який діапазон вони приймають.

Кешування та ліміти

Курси кешуються на 60 секунд, порівняння мереж на 30 секунд, відгуки й комісії на 5 хвилин, довідники на годину. Комісії мереж оновлюються раз на 6 годин. Відповіді значно менші за ліміт Claude Code у 25 000 токенів. На рівні HTTP діє ліміт 60 запитів на хвилину з однієї IP-адреси.

Готові спробувати Kurslog MCP? Налаштування в один клік. Без логіну. Без API-ключа. Безкоштовно.
Додати до Claude