Dokumentacja serwera MCP

Narzędzia, które GpwAlert udostępnia asystentom AI: nazwy, parametry i kody błędów.

Połączenie

  • Adres serwera: https://gpwalert.com/mcp (Streamable HTTP, OAuth).
  • Wszystkie narzędzia są tylko do odczytu i wymagają aktywnego planu Premium.
  • Spółkę podajesz jako UUID, ticker (np. CDR) albo friendlyUrl.
  • Błąd wraca w polu error.code: subscription_required, company_not_found, invalid_argument, portfolio_not_found, portfolio_access_disabled.

list_companies

Lista albo wyszukiwarka spółek ze stronicowaniem. Filtr indeksu zwraca aktualny skład. Domyślnie tylko spółki aktywne.

ParametrTypOpis
query string opcjonalny Nazwa, ticker albo slug. Krótką nazwę zamienia na ticker, np. INTROL na INL.
page int opcjonalny Numer strony, minimum 1. Domyślnie 1.
perPage int opcjonalny Wyników na stronę, 1-100. Domyślnie 50.
sector string opcjonalny Sektor, np. real_estate, construction, finance, energy, technology.
activities string[] opcjonalny Kody działalności, dopasowanie dowolnego z listy.
minimumImportance string opcjonalny Minimalna waga działalności: primary, significant, ancillary.
includeInactiveCompanies bool opcjonalny Czy dodać spółki wycofane. Domyślnie false.
index string opcjonalny Aktywne członkostwo w indeksie: WIG20, mWIG40, sWIG80.

get_company

Pełny profil spółki.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.

get_company_prices

Historia cen OHLC.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.
months int opcjonalny Miesięcy historii, 1-60. Domyślnie 12.

get_company_price_metrics

Wskaźniki z cen: stopy zwrotu, drawdown, SMA, RSI, MACD, płynność.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.

get_company_financials

Kwartalne dane finansowe w układzie pokazywanym w GpwAlert.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.

get_company_kpis

Kwartalne wartości KPI.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.

get_company_documents

Lista komunikatów ESPI spółki.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.
page int opcjonalny Numer strony, minimum 1. Domyślnie 1.
perPage int opcjonalny Wyników na stronę, 1-100. Domyślnie 20.

get_company_document

Jeden komunikat ESPI z metadanymi załączników. Treść załącznika pobierzesz przez get_company_document_attachment.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.
document string wymagany UUID dokumentu albo jego friendlyUrl.
includeContent bool opcjonalny Tekst strony ESPI. Dla raportów okresowych to sam nagłówek, bez załączników. Domyślnie false.

get_company_document_attachment

Jeden załącznik komunikatu ESPI. Z includeContent=true zwraca pełny sparsowany tekst (PDF, XHTML, XBRL, XML).

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.
document string wymagany UUID dokumentu albo jego friendlyUrl.
attachment string wymagany UUID załącznika albo jego friendlyUrl.
includeContent bool opcjonalny Pełny sparsowany tekst załącznika. Domyślnie false.

get_company_dividends

Historia dywidend.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.

get_company_events

Wydarzenia spółki: walne, dywidendy, wyniki.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.

get_company_analyses

Tygodniowe analizy AI z pełną treścią.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.
limit int opcjonalny Ile analiz zwrócić, 1-100. Domyślnie 20.

get_company_recommendations

Rekomendacje analityków i raporty domów maklerskich, same skróty. Pełny tekst jest w narzędziach szczegółowych.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.

get_company_analyst_recommendation

Jedna rekomendacja analityka. Z includeReportContent=true dokleja sparsowany tekst raportu.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.
recommendation string wymagany UUID rekomendacji.
includeReportContent bool opcjonalny Pełny tekst raportu PDF. Domyślnie false.

get_company_brokerage_report

Jeden raport domu maklerskiego. Z includeReportContent=true dokleja sparsowany tekst.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.
report string wymagany UUID raportu.
includeReportContent bool opcjonalny Pełny tekst raportu PDF. Domyślnie false.

get_company_news

Zewnętrzne wiadomości o spółce.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.
days int opcjonalny Ile dni wstecz, 1-365. Domyślnie 30.

get_company_indices

Aktywne członkostwo spółki w indeksach GPW.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.

get_company_top_picks

Wpisy spółki w Top Spółkach AI: miesiąc, kwartał, rok.

ParametrTypOpis
company string wymagany UUID, ticker (np. CDR) albo friendlyUrl.
limit int opcjonalny Ile wpisów na typ okresu, 1-50. Domyślnie 12.

list_top_picks

Cały portfel Top Spółek AI za jeden miesiąc, kwartał albo rok: uzasadnienie, ceny i dywidendy w PLN, zmiana ceny, zwrot z dywidendą i zwrot portfela o równych wagach.

ParametrTypOpis
periodType string wymagany month, quarter albo year.
year int wymagany Rok, np. 2026. Minimum 2000.
period int opcjonalny Miesiąc 1-12 albo kwartał 1-4. Przy periodType=year pomiń.

list_market_data

Aktualne serie: USD/PLN, EUR/PLN, miedź, srebro, złoto, aluminium, cynk, Brent, stopa referencyjna NBP, WIBOR 3M, POLSTR 1M. Każda seria ma ostatnią wartość, datę i zmiany 1D, 1M, YTD, 1Y. Zmiany stóp są w punktach procentowych, walut i surowców w procentach.

ParametrTypOpis
group string opcjonalny fx, commodity albo rate.

get_market_data_series

Jedna seria i jej historia od 2025-01-01. Wartości to stringi dziesiętne. Podaj range albo from i to, nie oba naraz. W oknie jest też ostatni odczyt z dnia startu lub wcześniejszy, więc nbp_ref pokazuje stopę obowiązującą na początku.

ParametrTypOpis
series string wymagany usd_pln, eur_pln, copper_usd_t, silver_usd_oz, gold_usd_oz, aluminium_usd_t, zinc_usd_t, brent_usd_bbl, nbp_ref, wibor_3m, polstr_1m.
range string opcjonalny 90d, ytd, 1y, 2y, all. Domyślnie 1y, gdy nie ma from i to.
from string opcjonalny Data początkowa włącznie, Y-m-d. Nie łącz z range.
to string opcjonalny Data końcowa włącznie, Y-m-d. Nie łącz z range.

get_my_portfolio

Portfel zalogowanego użytkownika: otwarte pozycje (ilość, średnia cena, ostatnia cena, wartość, wynik niezrealizowany, waga, zmiana tygodniowa), sumy (wartość, gotówka, papiery, wyniki, dywidendy, prowizje) i pozycje zamknięte. Kwoty w PLN. Wymaga włączonego dostępu do portfela w ustawieniach MCP.

Bez parametrów.

get_my_portfolio_transactions

Transakcje portfela zalogowanego użytkownika od najnowszych: kupno, sprzedaż, dywidenda, wpłata, wypłata. Kwoty w PLN. pricePerShare to cena akcji, dywidenda na akcję albo pełna kwota wpłaty i wypłaty. Te same warunki dostępu co get_my_portfolio.

ParametrTypOpis
type string opcjonalny buy, sell, dividend, deposit, withdrawal.
from string opcjonalny Data początkowa włącznie, YYYY-MM-DD.
to string opcjonalny Data końcowa włącznie, YYYY-MM-DD.
limit int opcjonalny Rozmiar strony, 1-500. Domyślnie 100.
offset int opcjonalny Ile pasujących transakcji pominąć. Domyślnie 0.

Podłącz GpwAlert do swojego asystenta

Dane o spółkach GPW, ESPI i Twój portfel w Cursorze, Claude i ChatGPT. Wymaga planu Premium.

Zacznij za darmo

Bez karty kredytowej • Miesiąc próbny gratis