English · China Dividend Value Screener MCP

Current version: 1.0.0

A-share dividend + value screening over MCP — dividend yield, PE/PB, ROE and market-cap filters on free Eastmoney data. No API key, no upstream fees, no data vendor contract.

4 tools · remote Streamable HTTP · Proprietary

Languages: English · 简体中文 · 繁體中文

---

Why this exists

Screening Chinese A-shares for a dividend-value strategy normally means either paying a data vendor or hand-scraping data.eastmoney.com. This server packages the Eastmoney data-centre reports behind four typed MCP tools, so an agent can answer questions like:

• "Show me A-shares yielding over 6% with PE under 10 and ROE above 12%."
• "Has China Merchants Bank paid a dividend every year?"
• "What is ICBC trading at right now?"

The upstream endpoint is public and free. The cost of running this server is the compute, not the data.

Tools

Tool	Billable	What it does
screen_dividend_stocks	$0.02	Screen by dividend yield floor + PE ceiling + PB ceiling + ROE floor + market-cap floor. Joins the dividend-plan register with live valuation and the latest ROE.
screen_value_stocks	$0.02	Classic value screen: low PE_TTM, low PB, positive operating cash flow, market-cap floor.
get_dividend_profile	$0.01	One stock: recent payout plans (yield, pre-tax amount per 10 shares, ex-dividend date, implementation status), per-plan payout ratio, consecutive dividend years, current valuation and ROE.
get_stock_valuation	$0.01	One stock: close, PE_TTM, PB_MRQ, PS_TTM, operating cash-flow ratio, market cap, latest ROE.
describe_fields	free	Field provenance: which upstream report and column each number comes from, whether it is reported or derived, its unit, and the known caveat. Never billed — provenance is not a paid feature.

initialize and tools/list are always free — an agent must be able to connect and enumerate tools before spending anything.

Tool parameters

screen_dividend_stocks

Param	Default	Meaning
minDividendYieldPct	5	Minimum dividend yield, in percent
maxPE	15	Maximum PE_TTM
maxPB	3	Maximum PB_MRQ
minRoePct	null	Minimum ROE, in percent (null = no ROE filter)
minMktcapYi	30	Minimum market cap in 億 CNY (100M CNY)
annualOnly	false	Keep only annual-report plans, drop interim dividends
implementedOnly	false	Keep only plans already implemented, drop proposals
excludeST	true	Drop ST / *ST / delisting-risk names
excludeBank	false	Drop banks, insurers, brokers
sinceYear	last year	Earliest fiscal year of dividend plans
yieldBasis	plan	plan = the exchange's yield for one plan (v1.0 behaviour). ttm = every implemented cash dividend with an ex-date in the trailing 12 months, ÷ current close
limit	20	Max rows

Under yieldBasis: "ttm" the headline dividend_yield_pct becomes the trailing aggregate, and each row also carries ttm_dps, ttm_dividend_yield_pct and ttm_spans_fiscal_years. Measured effect: 索菲亚 reads 7.16% on one plan and 10.68% on TTM, because it pays twice a year.

screen_value_stocks — maxPE (10), maxPB (2), minMktcapYi (30), requirePositivePCF (true), excludeST (true), excludeBank (false), limit (20), tradeDate (optional).

get_stock_valuation — code (6-digit A-share code, e.g. 601398).

get_dividend_profile — code, years (5).

Data source

Three free, keyless Eastmoney reports, all served from the same public endpoint that powers data.eastmoney.com:

Report	Used for
RPT_VALUEANALYSIS_DET	PE_TTM, PB_MRQ, PCF, PS_TTM, close price, total market cap
RPT_SHAREBONUS_DET	Dividend plans, DIVIDENT_RATIO (the exchange's own dividend yield), amount per 10 shares, ex-dividend date, implementation status
RPT_LICO_FN_CPD	Weighted-average ROE, EPS, BPS

Data semantics you should know

• Interim dividends are not annualised. A plan filed against a 2026-06-30 period is a half-year yield. Use annualOnly: true when you want annual-report plans only. Every row carries a report_period label (2025A, 2026H1, …) so the basis is never hidden.
• ROE basis is labelled. The server prefers the newest annual report and falls back to the newest interim one; each row reports roe_basis (annual / interim) and roe_period, because a half-year ROE must not be silently compared against a 10% annual hurdle.
• Missing data stays missing. Anything that cannot be sourced is returned as null, never defaulted to 0 — a fabricated 0% yield is worse than an absent one.
• One trading day per screen. tradeDate in the response tells you exactly which session the valuation snapshot is from.
• DIVIDENT_RATIO is one plan, not the stock. It is the exchange's own yield for a single distribution, measured against the price on that plan's announcement date — it ignores a second payment in the same year and uses a historical price. get_dividend_profile therefore also returns a TTM block (ttm_dps, ttm_dividend_yield_pct, ttm_window, ttm_spans_fiscal_years): the sum of implemented cash dividends with an ex-date in the trailing 12 months, divided by the current close. Pre-tax. Amounts are quoted per 10 shares and divided by 10.
• Consecutive dividend years counts only money that was actually paid. 预披露 and 董事会决议通过 have no ex-date and may never be paid, so they no longer extend the streak. When the streak runs to the edge of the retrieved history, consecutive_years_is_lower_bound is true and the number is a floor.

Connect

Hosted on Apify (recommended)

https://<your-actor-run-id>.apify.actor/mcp

Send Authorization: Bearer <APIFY_TOKEN>. The endpoint speaks Streamable HTTP; POST JSON-RPC 2.0 messages (initialize, tools/list, tools/call).

Self-hosted deployment (on request)

The recommended way to use this server is the hosted endpoint above — zero setup, you call the tools and consume the screening results. The source code is private and available on request; self-hosted deployment of the server can be arranged by contacting PanStories. There is no public npx package and no public Git repository.

Example response

A-share dividend + value screen · trading day 2026-09-30
Filters: yield ≥ 5% · PE_TTM ≤ 20 · PB ≤ 3 · ROE ≥ n/a% · market cap ≥ 50億 CNY
Scanned 60 dividend plans from 2025 onwards, showing 3.

 1. 601216 君正集团 (化学原料) yield 7.95% [2025A] · PE 12.5 · PB 1.39 · ROE 11.78% (2025-12-31) · mktcap 383.09億
 2. 600861 北京人力 (专业服务) yield 7.23% [2025A] · PE 9.47 · PB 1.02 · ROE 16.99% (2025-12-31) · mktcap 72.63億
 3. 002572 索菲亚 (家居用品) yield 7.16% [2025A] · PE 11.55 · PB 1.11 · ROE 12.27% (2025-12-31) · mktcap 74.35億

Every tool returns both a human-readable summary (content) and machine-readable data (structuredContent), so agents never have to parse prose.

Pricing

Event	Price	Tools
mcp-screen	$0.02	screen_dividend_stocks, screen_value_stocks
mcp-profile	$0.01	get_dividend_profile, get_stock_valuation

Screens cost more because they fan out to three upstream reports; single-stock lookups take two. Discovery is free, and describe_fields is free on purpose. Set maxTotalChargeUsd on the run to cap autonomous agent spend.

Prices are unchanged by the v1.1.0 release: the new TTM fields ride on existing calls, and the new tool is deliberately not registered as a charge event.

Limitations

• A-shares only (Shanghai / Shenzhen / Beijing). No HK, US or Taiwan listings — see the companion mcp-stock-analyst server for those.
• No intraday data. Valuation snapshots are end-of-day.
• Not investment advice. This server screens public data. It does not know your position, your horizon or your tax situation.

Source & licence

Proprietary © PanStories. Source is available on request; the repository remains private. This server is offered as a hosted service (pay-per-event on Apify) — you consume the screening results, not the code.

Privacy — read-only and stateless; no accounts, no cookies, no trackers, no personal data collected. See the Privacy Policy below.

---

简体中文

当前版本：1.0.0

这是什么

A 股高股息 + 价值筛选 MCP 服务。用免费东方财富数据做股息率、PE/PB、ROE、市值门槛筛选，无需 API key，零上游数据成本。

五个工具

工具	计费	作用
screen_dividend_stocks	$0.02	按股息率下限 + PE 上限 + PB 上限 + ROE 下限 + 市值下限筛选；把分红方案台账与实时估值、最新 ROE 三张表做联结。可选 yieldBasis="ttm" 改用滚动 12 个月真实派息合计口径
screen_value_stocks	$0.02	经典价值筛选：低 PE_TTM、低 PB、经营现金流为正、市值门槛
get_dividend_profile	$0.01	单只股票：历次分红方案（股息率、每 10 股税前派息、除权日、实施进度）、单次派息率、连续分红年数、TTM 真实股息率、当前估值与 ROE
get_stock_valuation	$0.01	单只股票：收盘价、PE_TTM、PB_MRQ、PS_TTM、现金流市销比、市值、最新 ROE
describe_fields	免费	字段溯源：每个数字来自哪张报表哪一列、是实测值还是推导值、单位、以及已知口径坑。永不计费

initialize 与 tools/list 永久免费 —— 智能体必须先能连上并列出工具，才谈得上消费。

必须知道的数据口径

• 中期分红不做年化。 归属 2026-06-30 的方案就是半年口径的股息率。只要年报刊方案，把 annualOnly 设为 true。每行都带 report_period 标签（2025A／2026H1…），口径从不含糊。
• ROE 口径明示。 优先取最新年报 ROE，取不到才退回最新中报；每行都给出 roe_basis（annual／interim）与 roe_period —— 半年 ROE 不能悄悄拿去和「年化 10%」的门槛比。
• 取不到就是 null。 任何无法取到的数字一律返回 null，绝不默认为 0。编出来的 0% 股息率比缺失更害人。
• 每次筛选只对应一个交易日。 响应里的 tradeDate 明确告诉你估值快照取自哪一天。
• DIVIDENT_RATIO 是「单笔方案」不是「这只股票」。 它是交易所按该方案公告日的股价算的单次股息率：同年第二次派息不算，用的还是旧股价。因此 get_dividend_profile 额外返回 TTM 区块（ttm_dps、ttm_dividend_yield_pct、ttm_window、ttm_spans_fiscal_years）——滚动 12 个月内已实施现金分红合计 ÷ 当前收盘价（税前；派息额按每 10 股计，需 ÷10）。实测差异：索菲亚单笔口径 7.16%，TTM 口径 10.68%（一年两派）。
• 连续分红年数只算真的发了钱的分红。 预披露、董事会决议通过 没有除权日、也可能最终不发，不再延长连续年数；若连续年数一直顶到已取历史的边界，consecutive_years_is_lower_bound 为 true，该数字是下界。

接入

• Apify 托管（推荐）：https://<run-id>.apify.actor/mcp，带 Authorization: Bearer <APIFY_TOKEN>，Streamable HTTP 协议，POST JSON-RPC 2.0。
• 自托管部署（按需提供）：推荐用上面的托管端点，零配置、直接消费筛选结果。源码为私有、可按需提供；自托管部署请联系 PanStories。无公开 npx 包、无公开 Git 仓库。

计费

筛选类工具（screen_*）$0.02／次，单只查询（get_*）$0.01／次。筛选贵一倍是因为它要扇出到三张上游报表，单只查询只用两张。describe_fields 永久免费。

v1.1.0 不涨价：新增的 TTM 字段挂在既有调用上，新工具刻意不注册计费事件。

限制

• 仅 A 股（沪／深／京）。港股、美股、台股请用配套的 mcp-stock-analyst。
• 无盘中数据，估值快照为收盘口径。
• 不构成投资建议。本服务只做公开数据的筛选，不知道你的持仓、期限与税负。

源码与许可

专有（Proprietary）© PanStories。源码可按需提供；仓库保持私有。本服务以托管形式提供（Apify 按事件计费）—— 你消费的是筛选结果，不是代码。

隐私 / Privacy — 只读、无状态；无账号、无 Cookie、无追踪，不收集任何个人信息。详见下文 隐私政策。

---

繁體中文

當前版本：1.0.0

這是什麼

A 股高股息 + 價值篩選 MCP 服務。以免費東方財富資料做股息率、PE/PB、ROE、市值門檻篩選，無需 API key、零上游資料成本。

五個工具

工具	計費	作用
screen_dividend_stocks	$0.02	依股息率下限 + PE 上限 + PB 上限 + ROE 下限 + 市值下限篩選；將分紅方案台帳與即時估值、最新 ROE 三張表做聯結。可選 yieldBasis="ttm" 改用滾動 12 個月實際派息合計口徑
screen_value_stocks	$0.02	經典價值篩選：低 PE_TTM、低 PB、營業現金流為正、市值門檻
get_dividend_profile	$0.01	單一個股：歷次分紅方案（股息率、每 10 股稅前派息、除權日、實施進度）、單次派息率、連續分紅年數、TTM 真實股息率、當前估值與 ROE
get_stock_valuation	$0.01	單一個股：收盤價、PE_TTM、PB_MRQ、PS_TTM、現金流市銷比、市值、最新 ROE
describe_fields	免費	欄位溯源：每個數字來自哪張報表哪一欄、是實測值還是推導值、單位，以及已知口徑陷阱。永不計費

initialize 與 tools/list 永久免費 —— 智慧體必須先能連上並列出工具，才談得上消費。

必須知道的資料口徑

• 期中分紅不做年化。 歸屬 2026-06-30 的方案就是半年口徑的股息率。只要年報方案，請把 annualOnly 設為 true。每一列都帶 report_period 標籤（2025A／2026H1…），口徑從不含糊。
• ROE 口徑明示。 優先取最新年報 ROE，取不到才退回最新期中報；每一列都給出 roe_basis（annual／interim）與 roe_period —— 半年 ROE 不該悄悄拿去和「年化 10%」的門檻相比。
• 取不到就是 null。 任何無法取得的數字一律回傳 null，絕不預設為 0。捏造出來的 0% 股息率比缺漏更糟。
• 每次篩選只對應一個交易日。 回應中的 tradeDate 明確指出估值快照取自哪一天。
• DIVIDENT_RATIO 是「單一方案」而非「這檔股票」。 它是交易所依該方案公告日股價算出的單次股息率：同一年的第二次派息不計入，用的還是舊股價。因此 get_dividend_profile 額外回傳 TTM 區塊（ttm_dps、ttm_dividend_yield_pct、ttm_window、ttm_spans_fiscal_years）——滾動 12 個月內已實施現金分紅合計 ÷ 當前收盤價（稅前；派息額為每 10 股，需 ÷10）。實測差異：索菲亞單一方案口徑 7.16%，TTM 口徑 10.68%（一年兩次派息）。
• 連續分紅年數只算真正發出去的錢。 預披露、董事會決議通過 沒有除權日、也可能最終不發，不再延長連續年數；若連續年數頂到已取歷史的邊界，consecutive_years_is_lower_bound 為 true，該數字是下界。

接入

• Apify 託管（推薦）：https://<run-id>.apify.actor/mcp，帶 Authorization: Bearer <APIFY_TOKEN>，Streamable HTTP 協定，POST JSON-RPC 2.0。
• 自託管部署（按需提供）：推薦用上面的託管端點，零配置、直接消費篩選結果。原始碼為私有、可依需求提供；自託管部署請聯絡 PanStories。無公開 npx 套件、無公開 Git 倉庫。

計費

篩選類工具（screen_*）$0.02／次，單一個股查詢（get_*）$0.01／次。篩選貴一倍是因為它要扇出到三張上游報表，單一個股查詢只用兩張。describe_fields 永久免費。

v1.1.0 不漲價：新增的 TTM 欄位掛在既有呼叫上，新工具刻意不註冊計費事件。

限制

• 僅 A 股（滬／深／京）。港股、美股、台股請用配套的 mcp-stock-analyst。
• 無盤中資料，估值快照為收盤口徑。
• 不構成投資建議。本服務僅就公開資料做篩選，不知道你的持倉、期限與稅負。

原始碼與授權

專有（Proprietary）© PanStories。原始碼可依需求提供；倉庫保持私有。本服務以託管形式提供（Apify 按事件計費）—— 你消費的是篩選結果，不是程式碼。

隱私 / Privacy — 唯讀、無狀態；無帳號、無 Cookie、無追蹤，不收集任何個人資訊。詳見下文 隱私政策。

---

Privacy Policy

Product: China Dividend Value Screener MCP (MCP server) Operator: PanStories Last updated: 2026-10-09 Effective date: 2026-10-09

This is the authoritative privacy policy for this hosted service. It is reproduced in full here because the source repository is private; the identical text also ships as PRIVACY.md in the repository.

1. Summary (TL;DR)

• The Service is a read-only MCP server. Its tools only read public A-share market data on free Eastmoney endpoints to screen for dividend/value metrics. They never modify, delete, or act on your systems.
• No accounts, no sign-up, no cookies, no advertising or analytics trackers.
• We do not sell, rent, or share your data with advertisers or data brokers.
• The only inputs are public A-share stock codes and screening filters (dividend yield, PE/PB, ROE, market cap). No personal data is required or requested.
• The server is stateless: each request is independent, with no session and no user profile.
• Hosting is provided by Apify; platform-level processing is governed by Apify's own privacy policy.

2. Data we process

Data	Source	Why we process it	Retention
Stock codes / screener parameters	You	To screen A-shares by dividend/value metrics	In memory for the duration of the request only
Numeric filters (yield, PE/PB, ROE, cap, years)	You	To bound the screening query	Request duration only
IP address + User-Agent	Your request	Transient rate-limiting only	In-memory window; not persisted, not logged to disk
Apify API token	Apify gateway	Authenticates the caller at the platform edge	Not seen or stored by the Service

3. What we do NOT collect

• No names, email addresses, phone numbers, or other personal identifiers.
• No trading accounts, brokerage credentials, positions, or portfolio data.
• No accounts, passwords, or credentials.
• No conversation history or tool-call content retained beyond the live request.
• No cookies, analytics, pixels, or advertising trackers.

4. Third parties / data recipients

To answer a query the Service fetches public market data from Eastmoney. Your screener parameters are forwarded to them; no personal data is included.

Recipient	Purpose	Notes
Eastmoney (data.eastmoney.com, datacenter-web.eastmoney.com)	Public A-share fundamentals and dividend data	Public market endpoints
Apify (hosting)	Runs the Standby container and meters usage	Subject to Apify's privacy policy

We do not disclose your inputs to any other third party.

5. Hosting and infrastructure

The hosted Service runs on Apify's Standby infrastructure. Apify may process operational metadata (timestamps, IP, billing records) as an independent controller. See https://apify.com/privacy-policy. The Service runs no database and keeps no persistent store of user data.

6. Self-hosted builds

The source is not publicly distributed. Where a self-hosted build exists, its operator is the data controller for anything that deployment processes.

7. Security

Transport is encrypted (TLS) at the Apify edge. All requests require the Apify gateway bearer token. See the repository's SECURITY.md for the threat model and vulnerability reporting.

8. Children's privacy

The Service is a developer tool not directed at children, and we do not knowingly process data from children under 16.

9. Your rights

Because we do not maintain user profiles or store personal data, there is generally no personal data to access, correct, or erase. If you believe we hold data about you, contact us (Section 11) and we will respond within 30 days.

10. Changes to this policy

We may update this policy as the Service evolves. Material changes will be reflected in the "Last updated" date and, where appropriate, in this README.

11. Contact

Privacy questions or requests: contact the operator via this Apify Store listing (Issues tab), or open an issue in the repository if you have access.

隐私政策（简体中文）

产品： China Dividend Value Screener MCP — A 股股息/价值筛选 MCP server 运营方： PanStories 最后更新： 2026-10-09

概要

• 本服务是只读 MCP server，工具仅读取东方财富免费接口的公开 A 股行情数据， 用于按股息/价值指标选股，不会修改、删除或操作用户的任何系统。
• 无账号、无注册、无 Cookie、无广告或分析追踪。
• 我们不会向广告商或数据经纪商出售、出租或共享你的数据。
• 唯一输入为公开 A 股代码与筛选条件（股息率、PE/PB、ROE、市值），不涉及个人信息。
• 服务无状态：每次请求独立处理，无会话、无用户画像。
• 托管由 Apify 提供，平台层处理受 Apify 隐私政策约束。

我们处理的数据

数据	来源	用途	保留
股票代码 / 筛选参数	调用方	按股息/价值指标筛选 A 股	仅请求期间驻留内存
数值筛选（股息率、PE/PB、ROE、市值、年限）	调用方	限定筛选查询	仅请求期间
IP + User-Agent	请求	仅用于限流	内存窗口，不落盘
Apify API token	Apify 网关	在平台边缘鉴权	本服务不接触、不存储

第三方（仅转发公开数据，不含个人信息）

• 东方财富（data.eastmoney.com / datacenter-web.eastmoney.com）：公开 A 股基本面与分红数据。
• Apify（托管）：运行 Standby 容器并计量。参见 https://apify.com/privacy-policy。

联系方式

通过本 Apify Store 详情页（Issues 标签）联系运营者；如有仓库权限，亦可在仓库提 issue。