agent rynku
Zaloguj się
Model Context Protocol
English

Serwer MCP z danymi polskiej giełdy

94 narzędzia, przez które Twój agent czyta Giełdę Papierów Wartościowych w Warszawie: notowania i świece śróddzienne, raporty ESPI i EBI, dane kwartalne wyciągnięte z dokumentów spółek, prognozy wyników z rozliczeniem trafności oraz analitykę portfela w złotych. Działa z każdym klientem, który mówi protokołem MCP.

Załóż konto i weź kluczZobacz wszystkie 94 narzędzia

Adres serwera: https://agentrynku.pl/api/mcp

Dane, nie zeskrobana strona

Raporty ESPI i EBI z kanału GPW, dane kwartalne wyciągnięte z dokumentów spółek, notowania z własnego potoku. Każda liczba niesie datę i źródło, a narzędzie ODMAWIA odpowiedzi zamiast zgadywać, gdy danych brakuje.

Transport HTTP, bez instalacji

Serwer stoi pod jednym adresem i mówi protokołem MCP przez HTTP. Nie musisz niczego instalować ani utrzymywać procesu po swojej stronie - wystarczy adres i klucz. Paczka npm jest tylko opcjonalnym mostem dla klientów, które uruchamiają lokalne polecenie.

Klucz per agent, zakresy uprawnień

Każdy klucz ma własny zakres. Agent do czytania rynku nie dostaje prawa zapisu do portfela, a operacje zapisujące są w osobnym zakresie niż odczyt.

Jak podłączyć

Klucz API wygenerujesz w ustawieniach konta. Poniższa konfiguracja mcpServers działa z każdym klientem czytającym ten format. Podłączysz go tym samym adresem HTTP i nagłówkiem Bearer.

{
  "mcpServers": {
    "agentrynku": {
      "type": "http",
      "url": "https://agentrynku.pl/api/mcp",
      "headers": {
        "Authorization": "Bearer TWOJ_KLUCZ"
      }
    }
  }
}

Klient, który nie łączy się z adresem HTTP, tylko uruchamia lokalne polecenie, podłączysz paczką agentrynku-mcp z npm: npx -y agentrynku-mcp ze zmienną AGENTRYNKU_API_KEY. Dokumentacja, przykłady konfiguracji i pełna lista narzędzi są w repozytorium na GitHubie.

O co zapytać agenta

  • „Co dziś raportuje KGHM i jaka jest prognoza?"
  • „Pokaż spółki z WIG20 po ostatnich wynikach"
  • „Które moje pozycje mają koncentrację powyżej 20%?"
  • „Ile zapłacę podatku od sprzedaży w tym roku?"

Czego serwer NIE robi

  • Nie składa zleceń i nie łączy się z rachunkiem maklerskim.
  • Nie daje porady inwestycyjnej - oddaje dane i wyliczenia.
  • Nie zgaduje: przy brakujących danych zwraca odmowę z powodem, a nie liczbę zastępczą.

Limity planów FREE i PRO

Po uruchomieniu planów każde zewnętrzne tools/call zużywa pulę MCP: 100 wywołań miesięcznie w FREE albo 10 000 w PRO.query_companion zużywa też jedną wiadomość z puli AI. Wykorzystanie i datę resetu zobaczysz w limitach konta.

Po wyczerpaniu puli serwer zwraca błąd JSON-RPC -32000 z polamicategory, used, limit,plan, resetAt i upgradeUrl. Zakres planów i ceny są w cenniku.

Wszystkie narzędzia (94)

Opisy poniżej są skrótem po polsku, po jednym zdaniu na narzędzie. Model dostaje przy wyborze narzędzia inny, dłuższy tekst po angielsku - razem z ostrzeżeniami o jednostkach i znanych pułapkach danych. Ten pełny opis czyta klient protokołu, nie człowiek.

Notowania i rynek

10

Kursy bieżące, świece dzienne i śróddzienne, ruchy sesji, puls sektorów i anomalie wolumenu na GPW.

  • compare_symbols

    Porównanie kilku spółek obok siebie.

  • get_cross_market_peers

    Odpowiedniki spółki na drugim rynku, z korelacją i różnicą wyceny - do porównania GPW z USA.

  • get_dividends

    Historia i znane przyszłe dywidendy spółki, z kwotą, datą, źródłem i świeżością.

  • get_intraday_candles

    Świece godzinowe z bieżącej i poprzednich sesji.

  • get_intraday_quote

    Kwotowanie w trakcie sesji: cena, otwarcie, zakres dnia, zmiana wobec zamknięcia.

  • get_market_anomalies

    Ruchy cen odstające od zwykłej zmienności spółki, wyłapane automatycznie.

  • get_price_series

    Świece OHLC i zmienność zrealizowana - do stop-lossów i wielkości pozycji.

  • get_spot_price

    Bieżąca cena jednej spółki, z informacją, czy pochodzi z zamknięcia, czy z kwotowania w trakcie sesji.

  • sector_pulse_pl

    Puls sektorów GPW: które radzą sobie dziś lepiej, a które gorzej.

  • whats_moving_now

    Co się dziś rusza na rynku - największe zmiany sesji.

Raporty i komunikaty spółek

10

Raporty ESPI i EBI, dane kwartalne wyciągnięte z dokumentów, kalendarz publikacji, konferencje wynikowe i walne zgromadzenia.

  • get_company_analysis

    Podgląd analizy fundamentalnej spółki. Pełna treść jest dostępna w PRO.

  • get_company_dossier

    Źródłowa pamięć decyzyjna: trwałe przewagi, słabości, otwarte ryzyka, potwierdzone wzorce i kontekst biznesowy.

  • get_conference_reminders

    Nadchodzące konferencje wynikowe spółek, które śledzisz.

  • get_conference_summary

    Streszczenie konferencji wynikowej: cytaty zarządu, prognozy i sygnały ostrzegawcze.

  • get_earnings_calendar

    Kalendarz zbliżających się raportów okresowych.

  • get_earnings_deepdive

    Pogłębione omówienie raportu kwartalnego: co zaskoczyło, co niepokoi, co zapowiedział zarząd.

  • get_news_history

    Historia depesz o spółce razem z ich oceną.

  • get_quarterly_kpis

    Wyniki kwartalne spółki: przychód, zysk, bilans i przepływy, wraz z oceną jakości każdego wiersza.

  • get_report_event

    Jeden raport kwartalny jako zdarzenie: co mówi, co rozliczył, co zmienił, co zostaje otwarte, z wiekiem i źródłem każdej liczby.

  • get_wza_summary

    Streszczenie walnego zgromadzenia akcjonariuszy.

Oceny i rankingi

11

Ocena Agenta Rynku na sześciu wymiarach, rankingi całego rynku i skanery szukające konkretnych układów.

  • find_dip_candidates

    Spółki, które mocno spadły, ale fundamenty trzymają.

  • find_opportunities

    Wyszukiwanie okazji według zadanych kryteriów.

  • find_overheat_candidates

    Spółki, które urosły szybciej, niż uzasadniają to wyniki.

  • get_ranking_performance

    Jak ranking sprawdzał się w przeszłości.

  • get_stock_rankings

    Ranking spółek GPW według wybranego kryterium.

  • get_sygnal_score

    Ocena spółki z GPW. Dokładny wynik 0-100, wymiary i uzasadnienie są dostępne w PRO. Do oceny wchodzą tylko wymiary z dowodem, najwyżej sześć: Płynność pokazujemy osobno i nie punktujemy.

  • get_top_opportunities

    Ta sama lista spółek spoza portfela co w kafelku Top okazje na pulpicie.

  • rank_revenue_growth

    Ranking wzrostu przychodów.

  • rank_thematic

    Ranking spółek w obrębie wybranego motywu inwestycyjnego.

  • run_predictive_scan

    Skan spółek pod kątem zbliżających się raportów i przewidywanego zaskoczenia.

  • screen_stocks

    Przesiew spółek GPW po kapitalizacji, dynamice EBITDA lub przychodów r/r, powiadomieniach insiderów o nabyciu i wybiciu z maksimum na wolumenie; osobno spółki, których nie dało się ocenić.

Prognozy wyników

6

Prognozy przychodu i zysku na następny kwartał wraz z ich rozliczeniem po publikacji raportu oraz drivery makro.

  • get_drivers

    Bieżące czynniki makro: surowce, waluty, stopy, nastroje na rynku amerykańskim.

  • get_evaluation_outcomes

    Rozliczenie dawnych alertów po cenach: co się sprawdziło, a co nie, na tle indeksu.

  • get_factor_context

    Zmiana wybranego czynnika makro dla spółki z udokumentowanym źródłem i ekspozycją.

  • get_forecast

    Prognoza wyników spółki na najbliższe kwartały. Wycena modelowa jest dostępna w PRO.

  • get_forecast_accuracy

    Historyczna celność modeli prognostycznych i to, czy model przeszedł bramkę jakości.

  • macro_attribution

    Co najprawdopodobniej stało za ostatnim ruchem WIG20.

Portfel i alokacja

15

Pozycje z wielu rachunków, stopa zwrotu, zmienność, koncentracja i rozjazd wobec docelowych wag.

  • analyze_thesis_exposure

    Rozkład portfela na ogniwa łańcucha wartości AI - gdzie masz ekspozycję, a gdzie dziurę.

  • compare_portfolio_risk_reward

    Ranking pozycji i watchlisty według relacji zysku do ryzyka.

  • get_concentration_risk

    Ile portfela stoi na jednej spółce, sektorze i rynku.

  • get_portfolio_analytics

    Krzywa kapitału portfela dzień po dniu, ze stopą zwrotu, obsunięciem, zmiennością i porównaniem z WIG-iem lub S&P 500.

  • get_portfolio_context

    Obraz portfela użytkownika: pozycje, gotówka, watchlista z oceną analityka i powodem obserwacji, cele alokacji. Analiza i wycena wymagają PRO.

  • get_portfolio_stats

    Statystyki ryzyka i wyniku portfela liczone z historii transakcji.

  • get_portfolio_value_history

    Historia wartości portfela w czasie.

  • get_total_portfolio_view

    Portfel zsumowany ze wszystkich rachunków maklerskich, przeliczony na jedną walutę.

  • modify_holdings

    Ręczna zmiana pozycji w portfelu.

  • modify_watchlist

    Dodanie lub usunięcie spółki z watchlisty.

  • recommend_diversification

    Propozycje dywersyfikacji tam, gdzie portfel jest skupiony.

  • recommend_position_size

    Podpowiedź wielkości pozycji z uwzględnieniem zmienności i koncentracji portfela. Wycena wymaga PRO.

  • set_cash_balance

    Ustawienie salda gotówki na rachunku.

  • submit_portfolio_snapshot

    Wgranie stanu rachunku z zewnętrznego brokera.

  • suggest_order_size

    Wielkość zlecenia z uwzględnieniem dostępnej gotówki na konkretnym rachunku.

Transakcje i podatki

5

Historia realizacji, zysk zrealizowany, jakość egzekucji wobec VWAP i wyszukiwanie strat do rozliczenia podatkowego.

  • analyze_trade_outcome

    Rozliczenie pojedynczej transakcji: co wyszło, a co nie.

  • find_tlh_opportunities

    Pozycje ze stratą, którą da się odliczyć od podatku w tym roku.

  • get_realized_pnl

    Zrealizowany wynik od początku roku i okazje do rozliczenia strat podatkowych.

  • get_transaction_history

    Historia transakcji użytkownika, od najnowszej.

  • submit_broker_transactions

    Wgranie historii transakcji do rozliczeń i podatków.

Sygnały, alerty i zdarzenia

19

Sygnały na spółkach z rozliczeniem trafności, alerty, zdarzenia wyceniane przez rynek i własne reguły decyzyjne.

  • cancel_priced_event

    Odwołanie śledzonego zdarzenia.

  • create_decision_rule

    Utworzenie reguły decyzyjnej, która ma pilnować warunku za Ciebie.

  • delete_decision_rule

    Usunięcie reguły decyzyjnej.

  • get_activity_feed

    Ostatnie zdarzenia na Twoim koncie.

  • get_alert_delivery_stats

    Statystyki dostarczania alertów: ile poszło, ile się nie udało.

  • get_alerts

    Alerty dostarczone temu użytkownikowi, z filtrami po spółce i klasyfikacji.

  • get_asset_signals

    Szanse i ryzyka wykryte automatycznie dla spółki, każde z podpiętym dowodem w danych.

  • get_my_alert_performance

    Skuteczność alertów, które dostałeś: ile się sprawdziło.

  • get_priced_events

    Lista śledzonych zdarzeń wycenionych.

  • get_signal_prediction_performance

    Celność liczbowych przewidywań ruchu ceny: trafienia, kierunek, średni błąd.

  • historical_event_hit_rate

    Jak podobne zdarzenia wpływały na cenę w przeszłości.

  • list_decision_rule_proposals

    Propozycje reguł decyzyjnych wynikające z Twojego zachowania.

  • list_decision_rules

    Lista Twoich reguł decyzyjnych.

  • list_webhook_events

    Zdarzenia z webhooka - do sprawdzenia, czy TradingView dochodzi do Agenta Rynku.

  • resolve_priced_event_now

    Natychmiastowe rozliczenie zdarzenia po bieżącej cenie.

  • submit_alert_feedback

    Ocena alertu - ten sam sygnał, co kciuki w Telegramie.

  • track_priced_event

    Zapisanie zdarzenia, którego wpływ na cenę chcesz rozliczyć później.

  • update_decision_rule

    Zmiana reguły decyzyjnej.

  • update_priced_event

    Zmiana szczegółów śledzonego zdarzenia.

Ryzyko rynkowe

4

Poziom ryzyka rynkowego, tematy ryzyka i zdarzenia mogące uderzyć w portfel.

  • get_event_risks

    Kalendarz zdarzeń makro, które mogą poruszyć rynkiem.

  • get_risk_dashboard

    Zbiorczy obraz ryzyka rynkowego: jego poziom i aktywne motywy razem.

  • get_risk_regime

    Ryzyko rynkowe: spokój, lekka nerwowość, silna nerwowość czy kryzys.

  • get_risk_themes

    Motywy ryzyka aktywne w tej chwili.

Obligacje Catalyst

3

Serie obligacji, arkusz zleceń i kalkulator wcześniejszego wykupu.

  • calculate_early_redemption

    Rachunek opłacalności wcześniejszego wykupu obligacji.

  • get_bond_orderbook

    Arkusz zleceń dla obligacji - na razie niedostępny, zwraca informację o odroczeniu.

  • get_bond_series

    Wyszukiwanie serii obligacji z Catalyst po emitencie, marży i terminie wykupu.

Konto, odprawa i diagnostyka

11

Dzienna odprawa rynkowa, rozmowa z asystentem, ustawienia agenta oraz stan potoku danych.

  • claim_feature_request

    Wzięcie zgłoszenia do pracy albo oddanie go do kolejki.

  • get_codex_pipeline_stats

    Statystyki potoku ekstrakcji danych ze sprawozdań.

  • get_daily_brief

    Odprawa na dziś: co się zmieniło w Twoim portfelu i na watchliście.

  • get_outcome_settlement_health

    Stan rozliczania wyników alertów i prognoz.

  • get_pipeline_health

    Stan potoków danych: świeżość źródeł, opóźnienia, awarie.

  • list_feature_requests

    Lista zgłoszeń i ich stan.

  • modify_chat_settings

    Ustawienia powiadomień: próg istotności, kanały, wyciszone klasy alertów.

  • modify_profile

    Zmiana profilu inwestora.

  • query_companion

    Zapytanie do asystenta Agenta Rynku w języku naturalnym.

  • set_agent_prefs

    Ustawienia zachowania agenta.

  • submit_feature_request

    Zgłoszenie błędu, pomysłu albo brakujących danych do zespołu Agenta Rynku.

Brakuje narzędzia?

Serwer ma narzędzie submit_feature_request, więc Twój agent może zgłosić brak sam, w trakcie pracy, bez wychodzenia z rozmowy. Zgłoszenia trafiają na tę samą tablicę, z której powstaje kolejka wdrożeń.