nbp_kursy_mcp

NBP MCP – kursy walut i złota

Wizualne

Add to Cart

Oficjalne kursy walut i złota NBP w Twoim AI

Serwer NBP Exchange Rates to narzędzie, które łączy Twojego asystenta AI bezpośrednio z Narodowym Bankiem Polskim. Dzięki niemu masz natychmiastowy dostęp do aktualnych tabel kursowych oraz cen złota, bez konieczności szukania ich na stronach internetowych. To rozwiązanie idealne dla przedsiębiorców i osób prywatnych – zamiast surowych liczb, otrzymujesz interaktywne karty walutowe oraz wykresy trendów, które pomagają w podejmowaniu decyzji finansowych.

Dostępne narzędzia (Tools)

  • getCurrencyRate – Pobiera aktualny lub historyczny kurs dla jednej z 12 głównych walut (m.in. USD, EUR, GBP, CHF). Wyświetla dane w formie wizualnej karty z podziałem na kurs kupna (Bid) i sprzedaży (Ask).
  • getGoldPrice – Sprawdza oficjalną cenę 1 grama złota w PLN (próba 1000). Dostępne są dane bieżące oraz historyczne od 2013 roku.
  • getCurrencyHistory – Generuje wykres historyczny kursu waluty dla wybranego okresu (maksymalnie 93 dni). Pozwala wizualnie ocenić trend (wzrostowy/spadkowy).

Dostępne prompty (Prompts)

  • get_exchange_rate – Szybkie sprawdzenie kursu wybranej waluty.
  • calculate_exchange_cost – Kalkulator kosztów, który automatycznie dobiera odpowiedni kurs (kupna lub sprzedaży) w zależności od tego, czy chcesz walutę kupić, czy sprzedać.

Jak to działa w praktyce?

Mechanizm jest prosty: Ty pytasz o walutę → AI pobiera dane z NBP → Serwer rysuje wykres lub kartę. Nie musisz pamiętać skomplikowanych komend. Wystarczy, że zapytasz o kurs dolara czy euro, a asystent sam wybierze odpowiednie narzędzie. Dane są pobierane w czasie rzeczywistym z API NBP.

Przykłady zastosowania

  1. Rozliczanie delegacji i faktur. Masz fakturę w Euro z konkretnego dnia? Wpisz: „Jaki był kurs EUR 15 czerwca 2025?”. AI poda Ci dokładny kurs z tego dnia, co pozwoli Ci poprawnie zaksięgować dokument.
  2. Planowanie wymiany walut (Wakacje/Biznes). Chcesz wiedzieć, czy to dobry moment na kupno dolarów? Zapytaj: „Pokaż wykres USD za ostatnie 3 miesiące”. Otrzymasz wykres z zaznaczonym trendem, dzięki czemu ocenisz, czy waluta tanieje, czy drożeje.
  3. Szybka kalkulacja kosztów. Kupujesz sprzęt za granicą? Użyj promptu kalkulacji: „Ile zapłacę za 1000 EUR?”. System automatycznie użyje kursu sprzedaży (Ask), czyli tego, który faktycznie zapłacisz w banku, a nie mylącego kursu średniego.
⚠️ Ważne ograniczenie: NBP publikuje kursy tylko w dni robocze (od poniedziałku do piątku, z wyłączeniem świąt). Jeśli zapytasz o kurs z weekendu, otrzymasz informację o braku danych.

Instrukcja instalacji

Serwer NBP to tzw. Remote MCP Server (serwer zdalny). Nie instalujesz go jako programu na dysku, a jedynie łączysz się z jego adresem URL.
⚠️ Ważne: Serwer wymaga autoryzacji. Podczas pierwszego użycia zostaniesz poproszony o zalogowanie się przez konto wtyczki.ai.

Claude Desktop

Wybierz metodę w zależności od Twojego planu w Claude. Metoda A: Menu Connectors Jest to dedykowana metoda dla serwerów zdalnych, która nie wymaga edycji plików.
  1. Wejdź w Settings -> Connectors.
  2. Kliknij przycisk dodawania nowego połączenia (Add New Connector).
  3. Wybierz typ połączenia HTTP/Remote i wpisz adres serwera: 
    https://nbp-rates.wtyczki.ai/mcp
  4. Postępuj zgodnie z instrukcjami logowania na ekranie.
   

Alice

Alice natywnie obsługuje zdalne serwery MCP.
  1. Otwórz ustawienia Alice i wejdź w zakładkę MCP Servers.
  2. Kliknij Add New.
  3. Jako Server Type wybierz koniecznie: HTTP (Streamable).
  4. W polu URL wklej adres: 
    https://nbp-rates.wtyczki.ai/mcp
  5. Zapisz. Alice połączy się z serwerem jak ze stroną internetową.

ChatGPT

W ekosystemie OpenAI serwery MCP funkcjonują jako Aplikacje (Apps).
  1. Wejdź w Ustawienia (Settings) -> Aplikacje (Apps).
  2. Wyszukaj aplikację po nazwie serwera lub skorzystaj z katalogu.
  3. Kliknij Połącz (Connect). Ponieważ jest to serwer zdalny, ChatGPT poprosi Cię o autoryzację kontem wtyczki.ai.

Rozwiązywanie problemów

  • Brak połączenia w Claude (Metoda B): Upewnij się, że masz zainstalowane Node.js i npx, ponieważ metoda manualna tego wymaga.
  • Błąd autoryzacji: Jeśli po dodaniu serwera narzędzia nie działają, sprawdź, czy przeszedłeś proces logowania (OAuth) w oknie, które powinno się pojawić.

Czy korzystanie z tego serwera jest płatne?

Samo API NBP jest darmowe i publiczne. Serwer MCP wtyczki.ai wymaga założenia konta, ale w podstawowym zakresie jest darmowy do użytku. Nie ponosisz opłat za dane bankowe.

Dlaczego widzę dwie ceny (Bid i Ask)?

To standard bankowy. Cena Bid (Kupno) to kwota, za którą bank odkupi od Ciebie walutę. Cena Ask (Sprzedaż) to kwota, którą musisz zapłacić bankowi, by kupić walutę. Zawsze istnieje między nimi różnica, zwana spreadem.

Czy mogę sprawdzić kursy innych walut, np. chińskiego juana?

Nie, ten serwer obsługuje obecnie 12 głównych walut: USD, EUR, GBP, CHF, AUD, CAD, SEK, NOK, DKK, JPY, CZK, HUF. Są to waluty z Tabeli C NBP.

Co zrobić, jeśli serwer nie działa?

Sprawdź, czy nie przekroczyłeś limitu zapytań lub czy data, o którą pytasz, nie jest świętem. Jeśli problem się powtarza, spróbuj odświeżyć połączenie (przycisk Refresh w widżecie).

SZYBKA INSTALACJA

URL 
https://nbp-rates.wtyczki.ai/mcp