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

Ця сторінка документує п'ять MCP-інструментів конектора Kurslog. Усі інструменти тільки для читання (readOnlyHint: true). Відповіді — JSON, добре вкладаються в ліміт MCP у 25 000 токенів.

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

list_currencies

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

Cache TTL: 3600 с.

Аргументи:

{
  "locale": "uk",
  "only_with_rates": true,    // за замовч. true
  "limit": 200                // 1..300, за замовч. 200
}

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

{
  "count": 200,
  "locale": "uk",
  "currencies": [
    {"code": "usdt-trc20", "name": "USDT TRC20", "asset": "USDT",
     "popularity": 1, "tags": ["USDT"], "has_rates": true},
    {"code": "bitcoin", "name": "Bitcoin", "asset": "BTC",
     "popularity": 2, "tags": ["Crypto"], "has_rates": true}
  ]
}

find_best_rate

Призначення: топ-3 найкращих пропозицій для пари, опціонально з містом.

Cache TTL: 60 с.

Аргументи:

{
  "from_currency": "usdt-trc20",
  "to_currency": "cash-uah",
  "city": "kyiv",          // опц.
  "locale": "uk"
}

Приклад відповіді:

{
  "direction": {"from": "usdt-trc20", "to": "cash-uah", "city": "kyiv"},
  "best_offers": [
    {
      "exchanger_name": "Dvizh",
      "exchanger_slug": "dvizh",
      "exchanger_rating": 5.0,
      "trust_status": "Diamond",
      "rate_in": 1,
      "rate_out": 44.13,
      "reserves": 170916400.39,
      "min_amount": 566.45,
      "max_amount": 2000000,
      "kurslog_link": "https://kurslog.com/usdt-trc20-to-cash-uah-in-kyiv"
    }
    // ... до 3 елементів
  ],
  "disclaimer": "Rates may be stale up to 5 minutes..."
}

Порожній результат: якщо немає обмінників (невірна пара, неіснуюче місто) — повертається структурований success із results: [] і пояснювальним message, а не виняток.

compare_exchangers

Призначення: ширший список (до 20) з trust score, резервами, посиланнями на профіль.

Cache TTL: 60 с.

Аргументи:

{
  "from_currency": "bitcoin",
  "to_currency": "monobank-uah",
  "limit": 10,             // 1..20, за замовч. 10
  "city": null,            // опц.
  "locale": "uk"
}

Той самий формат відповіді, що й у find_best_rate, але масив exchangers до limit елементів, кожен збагачений trust_score (число) і profile_link.

get_exchanger_profile

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

Cache TTL: 600 с.

Аргументи:

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

Приклад відповіді:

{
  "name": "Digichanger",
  "slug": "digichanger",
  "status": "active",
  "founding_date": "2023-05-19",
  "website": "https://www.digichanger.pro",
  "trust": {
    "label": "Diamond",
    "name": "diamond",
    "explanation": "Відгуки: 3338 у 4 моніторингах. На ринку: 3 роки.",
    "domain_age_years": 3.01
  },
  "kurslog_profile": "https://kurslog.com/exchanger/digichanger"
}

find_cities_for_direction

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

Cache TTL: 3600 с.

Аргументи:

{
  "from_currency": "usdt-trc20",
  "to_currency": "cash-eur",
  "limit": 15,             // 1..30, за замовч. 15
  "locale": "uk"
}

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

{
  "direction": {"from": "usdt-trc20", "to": "cash-eur"},
  "count": 15,
  "cities": [
    {"city": "Київ", "slug": "kyiv", "exchanger_count": 16,
     "best_rate": 0.0234, "kurslog_link": "https://kurslog.com/usdt-trc20-to-cash-eur-in-kyiv"}
    // ...
  ]
}

Обробка помилок

Кожен інструмент дотримується конвенції MCP. Невдалі запити чи невідомі slug-и не підіймають MCP isError: true. Натомість повертається структурований порожній результат із полем message людською мовою. Це дозволяє Claude давати корисну відповідь, а не stack trace.

Rate limits

На рівні nginx діє ліміт 60 req/min/IP. Разом із per-tool кешуванням, при звичайному використанні Claude ви ніколи не впиратиметесь у нього. Якщо все-таки впрётесь — отримаєте 429 від HTTP-шару.