Masz pytania lub problemy? Napisz w GitHub Discussions.

Przeliczaj waluty i sprawdzaj bieżące lub historyczne kursy wymiany bezpośrednio w asystencie AI, korzystając z oficjalnego serwera Model Context Protocol. Dane dzienne sięgają roku 1948.

Dodaj https://mcp.frankfurter.dev/ jako zdalny serwer HTTP. Bez klucza API i bez rejestracji.

ChatGPT

  1. Otwórz Ustawienia i wybierz Aplikacje (lub Konektory).
  2. Kliknij w prawym górnym rogu Zaawansowane ustawienia i włącz Tryb programisty, aby tworzyć własne aplikacje.
  3. Wróć do menu Aplikacje i kliknij Utwórz aplikację (lub Utwórz konektor).
  4. Wpisz adres endpointu: https://mcp.frankfurter.dev/.
  5. Wybierz uwierzytelnianie: Brak.

Claude

W Claude Code:

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

W Claude Desktop lub Claude.ai:

  1. Otwórz Ustawienia i wybierz Konektory.
  2. Kliknij Dodaj niestandardowy konektor.
  3. Wpisz adres endpointu: https://mcp.frankfurter.dev/.
  4. Kliknij Dodaj. Następnie włącz konektor w interfejsie czatu.

Inne klienty

Dodaj do konfiguracji MCP (Cursor, Windsurf, VS Code itp.):

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

Narzędzia

Po nawiązaniu połączenia asystent AI ma dostęp do następujących narzędzi:

convert
Przelicza kwotę między dwiema walutami. Zwraca przeliczoną kwotę oraz zastosowany kurs.
Parametry:
  • amount (liczba, wymagany): Całkowita kwota do przeliczenia.
  • from (string, wymagany): Kod waluty lub aktywa źródłowego (np. USD, XAU lub BTC).
  • to (string, wymagany): Kod waluty lub aktywa docelowego (np. EUR).
  • date (string, opcjonalny): Określona data YYYY-MM-DD dla przeliczeń historycznych.
  • provider (string, opcjonalny): Identyfikator źródła (np. ECB lub UST) dla opublikowanego kursu wybranej instytucji zamiast kursu łączonego. W przypadku źródeł tygodniowych, miesięcznych lub kwartalnych data w danym okresie zwraca obowiązujący kurs.
get_rates
Pobiera referencyjne kursy walut.
Parametry:
  • date (string, opcjonalny): Data kursu YYYY-MM-DD (domyślnie: najnowszy kurs).
  • base (string, opcjonalny): Kod waluty lub aktywa bazowego (domyślnie: EUR).
  • quotes (string lub tablica, opcjonalny): Filtruje wyniki według kodów walut lub aktywów.
  • provider / providers (string lub tablica, opcjonalny): Jeden lub więcej identyfikatorów źródeł wybranych instytucji.
list_currencies
Wyświetla listę obsługiwanych kodów walut, metali szlachetnych i kryptoaktywów wraz z ich nazwami.
list_providers
Wyświetla listę obsługiwanych instytucji wraz z kluczem, rodzajem kursu, częstotliwością i okresem pokrycia. Instytucje publikujące kilka zbiorów danych wymieniają też swoje zbiory. Klucz zbioru, np. NBP.B, podany jako provider wybiera tylko ten jeden.

Dla szeregów czasowych, zakresów dat lub danych hurtowych skorzystaj z REST API.