Довідник інструментів
Конектор 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-адреси.