Є запитання чи проблеми? Пишіть у GitHub Discussions.

Конвертуйте валюти й переглядайте поточні чи історичні курси прямо з AI-асистента через офіційний сервер Model Context Protocol. Щоденна історія сягає 1948 року.

Додайте https://mcp.frankfurter.dev/ як віддалений HTTP-сервер. Ключ API й реєстрація не потрібні.

ChatGPT

  1. Відкрийте Settings, потім Apps (або Connectors).
  2. У правому верхньому куті натисніть Advanced settings і увімкніть Developer mode, щоб дозволити власні застосунки.
  3. Поверніться до підменю Apps і натисніть Create app (або Create connector).
  4. Введіть URL ендпоінта: https://mcp.frankfurter.dev/.
  5. У розділі автентифікації (authentication) виберіть None.

Claude

У Claude Code:

claude mcp add frankfurter https://mcp.frankfurter.dev/

У Claude Desktop або Claude.ai:

  1. Відкрийте Settings, потім Connectors.
  2. Натисніть Add custom connector.
  3. Введіть URL ендпоінта: https://mcp.frankfurter.dev/.
  4. Натисніть Add, щоб завершити. Після підключення увімкніть конектор в інтерфейсі чату.

Інші клієнти

Додайте до конфігурації MCP (Cursor, Windsurf, VS Code тощо):

{
  "mcpServers": {
    "frankfurter": {
      "url": "https://mcp.frankfurter.dev/"
    }
  }
}

Інструменти

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

convert
Конвертує суму між двома валютами. За замовчуванням повертає лише сконвертовану суму та її валюту. Укажіть details: true, щоб також отримати курс, дату набрання чинності та джерело, якщо його вибрано.
Параметри:
  • amount (число, обов’язковий): Сума для конвертації.
  • from (рядок, обов’язковий): Код вихідної валюти чи активу (наприклад, USD, XAU або BTC).
  • to (рядок, обов’язковий): Код цільової валюти чи активу (наприклад, EUR).
  • date (рядок, необов’язковий): Конкретна дата YYYY-MM-DD для історичної конвертації.
  • provider (рядок, необов’язковий): Ключ джерела (наприклад, ECB або UST), щоб отримати курс, опублікований однією установою, замість зведеного. Дата всередині періоду джерела з щотижневою, щомісячною чи квартальною публікацією повертає чинний курс.
  • details (булеве значення, необов’язковий): Додає курс, дату набрання чинності та вибране джерело (за замовчуванням: false). Конвертація в ту саму валюту повертає курс 1 і дату null, без джерела.
get_rates
Повертає довідкові курси.
Параметри:
  • date (рядок, необов’язковий): Дата курсу YYYY-MM-DD (за замовчуванням остання).
  • base (рядок, необов’язковий): Код базової валюти чи активу (за замовчуванням: EUR).
  • quotes (рядок або масив, необов’язковий): Фільтрує результати за кодами валют чи активів.
  • provider (рядок або масив, необов’язковий): Один або кілька ключів джерел. У власній базовій валюті джерела цифри такі, як їх опубліковано, з датою набрання чинності.
Застарілий псевдонім providers досі приймається. Використовуйте або provider, або providers, але не обидва.
list_currencies
Знаходить підтримувані коди валют, дорогоцінних металів і криптоактивів та їхні назви, включно з історичними валютами. Без фільтра повертає всі коди.
Параметри:
  • query (рядок, необов’язковий): Код або фрагмент назви без урахування регістру. Точний збіг коду має пріоритет над частковими.
list_providers
Знаходить джерела з ключем, типом курсу, частотою та датами покриття, щоб вибрати provider. Джерело, що публікує кілька рядів, також перелічує свої набори даних; передайте ключ набору даних, як-от NBP.B, у provider, щоб вибрати один із них. Фільтри поєднуються й не враховують регістр. Без них повертаються всі джерела.
Параметри:
  • query (рядок, необов’язковий): Ключ джерела або фрагмент назви. Точний збіг ключа має пріоритет над частковими.
  • country (рядок, необов’язковий): Дволітерний код країни (наприклад, US).
  • currency (рядок, необов’язковий): Підтримуваний код валюти, зокрема базової валюти джерела.

Якщо потрібні часові ряди, історичний діапазон або масові дані, використовуйте REST API.