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) albofriendlyUrl. - 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.
| Parametr | Typ | Opis | |
|---|---|---|---|
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.
| Parametr | Typ | Opis | |
|---|---|---|---|
company |
string | wymagany | UUID, ticker (np. CDR) albo friendlyUrl. |
get_company_prices
Historia cen OHLC.
| Parametr | Typ | Opis | |
|---|---|---|---|
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ść.
| Parametr | Typ | Opis | |
|---|---|---|---|
company |
string | wymagany | UUID, ticker (np. CDR) albo friendlyUrl. |
get_company_financials
Kwartalne dane finansowe w układzie pokazywanym w GpwAlert.
| Parametr | Typ | Opis | |
|---|---|---|---|
company |
string | wymagany | UUID, ticker (np. CDR) albo friendlyUrl. |
get_company_kpis
Kwartalne wartości KPI.
| Parametr | Typ | Opis | |
|---|---|---|---|
company |
string | wymagany | UUID, ticker (np. CDR) albo friendlyUrl. |
get_company_documents
Lista komunikatów ESPI spółki.
| Parametr | Typ | Opis | |
|---|---|---|---|
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.
| Parametr | Typ | Opis | |
|---|---|---|---|
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).
| Parametr | Typ | Opis | |
|---|---|---|---|
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.
| Parametr | Typ | Opis | |
|---|---|---|---|
company |
string | wymagany | UUID, ticker (np. CDR) albo friendlyUrl. |
get_company_events
Wydarzenia spółki: walne, dywidendy, wyniki.
| Parametr | Typ | Opis | |
|---|---|---|---|
company |
string | wymagany | UUID, ticker (np. CDR) albo friendlyUrl. |
get_company_analyses
Tygodniowe analizy AI z pełną treścią.
| Parametr | Typ | Opis | |
|---|---|---|---|
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.
| Parametr | Typ | Opis | |
|---|---|---|---|
company |
string | wymagany | UUID, ticker (np. CDR) albo friendlyUrl. |
get_company_analyst_recommendation
Jedna rekomendacja analityka. Z includeReportContent=true dokleja sparsowany tekst raportu.
| Parametr | Typ | Opis | |
|---|---|---|---|
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.
| Parametr | Typ | Opis | |
|---|---|---|---|
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.
| Parametr | Typ | Opis | |
|---|---|---|---|
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.
| Parametr | Typ | Opis | |
|---|---|---|---|
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.
| Parametr | Typ | Opis | |
|---|---|---|---|
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.
| Parametr | Typ | Opis | |
|---|---|---|---|
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.
| Parametr | Typ | Opis | |
|---|---|---|---|
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.
| Parametr | Typ | Opis | |
|---|---|---|---|
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.
| Parametr | Typ | Opis | |
|---|---|---|---|
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 darmoBez karty kredytowej • Miesiąc próbny gratis