Agent Rynku - Warsaw Stock Exchange (GPW) data for your agent

Agent Rynku MCP：面向 Agent 的华沙证券交易所数据

通过托管的 MCP 服务获取 GPW 公司财务数据，无需创建账户。Agent Rynku 会返回报告期间、货币、来源和质量检查结果。缺失数据会明确标示。

每个公开工具的参数和实际响应文档：agentrynku.pl/docs。

无需 API 密钥即可连接

端点使用 Streamable HTTP：

https://agentrynku.pl/api/mcp

适用于可读取此配置格式的客户端：

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

对于可启动本地命令的客户端，此软件包使用 mcp-remote 将 stdio 桥接到托管的服务。需要 Node 20.18.1 或更高版本：

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

公开数据无需 Authorization 标头或环境变量。

公开工具

工具	返回内容	请求限制
search_gpw_companies	按名称、股票代码、别名或 ISIN 搜索 GPW 公司，并返回规范化代码和公司 URL	20 条结果
get_quarterly_kpis	季度财务数据、报告范围、货币、单位、来源和质量门槛	20 个季度
get_financial_ratios	季度利润率和权益／资产比率，并说明公式及数值不可用的原因	20 个季度
get_public_earnings_calendar	GPW 已知的预定报告，以及来源和抓取日期	90 天，100 项事件
get_public_price_history	存储的 GPW 日 OHLCV 数据，包括来源、日期、比例和截断信息；不会按需从供应商获取数据	1-3650 个日历日，500 根 K 线
get_public_dividends	已知的发行人 WZA 股息决议：每股金额、货币、日期和来源	100 项事件

可以从以下问题开始：“查找 KGHM，并显示其最新季度业绩及报告来源。”然后询问 EBITDA 利润率，或接下来 30 天内预定发布的 GPW 报告。

直接公开调用：

curl -sS 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/call","params":{"name":"get_quarterly_kpis","arguments":{"symbol":"KGHM","quartersBack":1}}}'

公开调用受速率限制和响应大小限制。HTTP 429 响应包含 Retry-After。数据覆盖并不完整：日历为空并不能证明没有报告，WZA 响应为空也不能证明某家公司不支付股息。比率基于各个季度报告，并在每一行注明范围；这些比率不是 TTM，也不是基于价格的估值倍数。财务数据涵盖发行人报告和 GPW 公告；不包括门户网站数据库及来自门户网站的字段。存储的 GPW 股票日价格历史数据为公开数据，不包括指数、ETF 和债券；盘中数据及供应商提供的股息历史数据不公开。价格响应包含来源、存储序列的更新时间和实际 K 线日期。每根 K 线的比例和调整信息均予以保留；比例未知和货币为 null 表示未记录相关元数据。拆股或派息后，调整后的历史数据可能会发生变化。数据覆盖范围可能短于请求的时间窗口，截断情况会明确标示。

带密钥的其他工具

投资组合、提醒、预测、日内行情及其他功能需要账户和来自设置的 API 密钥。匿名 tools/list 会返回六个公开工具。使用密钥发现工具时，会返回该密钥权限范围允许使用的工具。实时目录由服务器注册表生成；TOOLS.md是该目录的快照。

使用密钥后，Agent 还可以保存、编辑和监控用户自己的公司投资论点：set_thesis（创建、编辑或清除）、get_my_theses（状态、状态历史记录、报告发布后的待处理审核）、confirm_thesis_review，以及 get_alerts 中带有 kind 的投资论点提醒。

对于 HTTP，请添加 Authorization: Bearer YOUR_KEY。对于 stdio 桥接程序，请添加：

"env": { "AGENTRYNKU_API_KEY": "YOUR_KEY" }

桥接程序会在启动时通过一次数据调用验证提供的密钥。此检查可能会消耗账户额度。未提供密钥时，不会验证密钥。请妥善保管密钥：其权限范围可能同时允许读取和相关写入操作。

不带密钥的公开调用不会消耗账户额度。使用密钥的调用在 FREE 方案下每月限 100 次，在 PRO 方案下每月限 10,000 次。query_companion 还会消耗一条 AI 消息。请参阅定价和账户用量。

此服务器不会下单，也不会连接券商账户。源报告和许多工具说明均为波兰语。英文设置指南、波兰语指南、方法论、问题反馈。

波兰语

无需账户和密钥即可为 Agent 提供 GPW 数据：公司搜索、季度业绩、利润率、公开报告日历、已知的 WZA 股息决议以及数据库中的每日价格历史记录。将客户端连接到 https://agentrynku.pl/api/mcp，且不添加 Authorization 标头；或者运行 npx -y agentrynku-mcp。

投资组合、提醒、预测和日内行情需要密钥。密钥也可能授予写入权限。没有数值不代表数值为零；没有已知日期也不代表没有报告或股息。使用说明和目录。

验证

在此代码库中，运行 npm ci 后，执行 npm run test:live，即可在不使用密钥的情况下检查实时 HTTP 端点和 stdio 桥接程序。该命令会读取公开的 KGHM 业绩数据，并检查私有写入操作是否被拒绝。若要测试开发端点：npm run test:live -- http://localhost:3104/api/mcp。

许可证

桥接程序代码和文档采用 MIT 许可证。服务器返回的数据受 Agent Rynku 使用条款约束。

1.2.1：原始报告文件

带密钥的 get_report_event 响应包含 zdarzenie.zrodla[].zalaczniki，其中列有 {nazwa, url}，指向与该报告事件关联的发行方原始附件。列表为空表示未记录有效的附件链接；如果有来源 url，请将其作为公告页面使用。这不是 Agent Rynku 分析报告的 PDF/Word 导出文件。此工具仍需要带有 read:portfolio 权限范围的 API 密钥，且公司必须在该账户的权限范围内。公开访问和传输方式均保持不变。请参阅工具目录。

1.2.2：在文件链接旁附上来源页面

始终在附件链接旁附上报告中记录的来源公告页面。如果直接文件无法打开，用户可以通过该页面下载。请准确复制每个附件 URL，包括下划线和查询参数。Agent Rynku 网页和 Telegram 聊天会直接呈现工具结果中的原始文件名和 URL。将分析与原始文件一并请求时，会保留分析内容并添加来源链接。此文档补丁不会更改 MCP 响应字段、访问规则或传输方式。