agentrynku-mcp

MCP server for the Warsaw Stock Exchange (GPW): quotes, ESPI/EBI filings with assessments, quarterly KPIs, forecasts and portfolio tools. Stdio bridge to the hosted Agent Rynku server.

latest

Source

npm

Version: 1.0.0

Version published: 10 hours ago

Maintainers: 1

Created: 10 hours ago

Source

Agent Rynku MCP: Warsaw Stock Exchange (GPW) data for your AI agent

Agent Rynku is a hosted Model Context Protocol server with 93 tools for the Polish stock market: live and historical quotes, ESPI/EBI filings with an assessment of each one, quarterly KPIs extracted from company documents, earnings forecasts with a track record, and portfolio analytics in PLN.

Connect it to Claude, Cursor, or any MCP client and ask things like:

"What did KGHM report today, and how does it compare with the forecast?"
"Show WIG20 companies after their latest results."
"Which of my positions are above 20% concentration?"
"How much tax will I owe on this year's sales?"

Polski opis jest niżej.

Quick start

1. Get an API key. Create a free account at agentrynku.pl and generate a key in settings. The free account covers unlimited data tool calls; only the LLM-backed companion queries are metered. The bridge below makes one check call per start to verify the key.

2. Connect your client. The server speaks Streamable HTTP at:

https://agentrynku.pl/api/mcp

with the header Authorization: Bearer YOUR_KEY.

Claude Code

claude mcp add --transport http agentrynku https://agentrynku.pl/api/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Cursor and other clients with remote HTTP support

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

Claude Desktop and other clients that only run local commands

This package is a small stdio bridge to the hosted server (it uses mcp-remote):

{
  "mcpServers": {
    "agentrynku": {
      "command": "npx",
      "args": ["-y", "agentrynku-mcp"],
      "env": { "AGENTRYNKU_API_KEY": "YOUR_KEY" }
    }
  }
}

More configs in examples/.

Try before signing up: initialize and tools/list work without a key, so you can see the full catalogue first:

curl -s https://agentrynku.pl/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

What is inside

Area	Tools	Examples
Quotes and market	10	`get_spot_price`, `get_intraday_quote`, `get_price_series`, `whats_moving_now`, `sector_pulse_pl`
Filings and reports	10	`get_news_history`, `get_report_event`, `get_quarterly_kpis`, `get_company_analysis`, `get_earnings_calendar`
Scores, screens and rankings	10	`get_stock_rankings`, `get_sygnal_score`, `find_opportunities`, `find_dip_candidates`, `run_predictive_scan`
Forecasts and drivers	6	`get_forecast`, `get_forecast_accuracy`, `get_drivers`, `get_factor_context`
Signals, alerts and events	19	`get_alerts`, `get_asset_signals`, `track_priced_event`, `create_decision_rule`
Portfolio and allocation	15	`get_portfolio_context`, `get_concentration_risk`, `recommend_position_size`, `modify_watchlist`
Transactions and tax	5	`get_realized_pnl`, `get_transaction_history`, `find_tlh_opportunities`
Market risk	4	`get_risk_regime`, `get_risk_dashboard`, `get_event_risks`
Catalyst bonds	3	`get_bond_series`, `get_bond_orderbook`, `calculate_early_redemption`
Account, brief and diagnostics	11	`get_daily_brief`, `query_companion`, `set_agent_prefs`

Full list with descriptions: TOOLS.md. Portfolio tools read the portfolio you keep in your Agent Rynku account; key scopes decide which tools a key can see.

Scope and limits

Polish equities only (GPW main market and NewConnect), deliberately: filings are read in Polish, and extraction is built for the formats the GPW actually uses.
Tool names are English. Tool descriptions, the server's instructions, the web app and the source material (filings, reports) are Polish.
The server does not place orders, does not connect to a brokerage account and does not give investment advice. When data is missing it returns a refusal with a reason, never a substitute number.
Intraday quotes come from a delayed GPW feed (typically around 25 minutes behind).

Po polsku

Agent Rynku to serwer MCP z danymi Giełdy Papierów Wartościowych w Warszawie: 93 narzędzia, przez które Twój agent czyta notowania i świece śróddzienne, raporty ESPI i EBI z oceną każdego komunikatu, dane kwartalne wyciągnięte z dokumentów spółek, prognozy wyników z rozliczeniem trafności oraz analitykę portfela w złotych.

Załóż darmowe konto na agentrynku.pl i wygeneruj klucz API w ustawieniach.
Podłącz klienta pod adres https://agentrynku.pl/api/mcp z nagłówkiem Authorization: Bearer TWOJ_KLUCZ (przykłady wyżej). Klient, który umie uruchomić tylko lokalne polecenie (np. Claude Desktop), użyje tej paczki: npx -y agentrynku-mcp ze zmienną AGENTRYNKU_API_KEY.

Serwer nie składa zleceń, nie łączy się z rachunkiem maklerskim i nie daje porady inwestycyjnej. Pełny katalog narzędzi po polsku: agentrynku.pl/mcp i TOOLS.md.