AStockEvent
Summary: This server provides read-only MCP tools for querying structured Chinese A-share announcement events, including search, event detail, timelines, trust checks, deadline monitoring, and fund-portfolio event exposure.
Search events by stock codes, event types, shareholder names, or complex multi-filter queries with cursor pagination.
Retrieve full event records, lifecycle timelines, and trust/verification reports for a given event ID.
Find upcoming deadlines within 30 days, such as lockup expirations, reduction-plan deadlines, delisting periods, buyback deadlines, and regulatory reply dates.
Use specialized feeds for dividends, violations/penalties, restructuring/M&A, shareholder activity, risk signals, regulatory scrutiny, convertible bonds, and fund holdings × stock events.
Filter by status, confidence tier, date, severity/sentiment where supported, and paginate results.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
AStockEvent — MCP server for Chinese A-share regulatory filings
Current state folded from A-share filings — not a raw event dump.
An event feed tells you a plan was announced in June and amended in August. You still have to work out what is true today. This server does that fold for you: who is still selling down, which penalty cases are open, which inquiry letters are unanswered.
Every value links back to the source PDF published by the exchange, so you can check us.
Connect
This is a remote MCP server (Streamable HTTP). There is nothing to install — point your MCP client at the URL:
https://astockevent.com/mcp/No API key, no sign-up. Rate limits apply and the response tells you when you hit one.
{
"mcpServers": {
"astockevent": {
"url": "https://astockevent.com/mcp/"
}
}
}Prefer HTTP? The same data is available over REST — see
astockevent.com/docs, with the machine-readable
contract at /openapi.json.
Related MCP server: mcp-hkexnews
Tools
Tool | What it answers |
| What is in scope and what the limits are. Call this before concluding data is missing. |
| Filings held for one company, with source links and any extracted events; up to 50 per call, without list pagination. |
| Available parsed text and tables for one recent filing; long documents may be partial. |
| Collected filings of the same company matched by explicit document references. |
| Folded company state, or linked companies for a confirmed actor identifier. |
| One event plus its whole timeline, in a single call. |
| Events updated within seven days and linked to filings from the last seven Beijing calendar days, cursor-paged. |
| Cross-company discovery by filing type within the last seven Beijing calendar days. |
Discovery includes today and uses filing dates, not the age of the case. A new filing can mention an old case. matched_filing identifies the qualifying filing and its source; root event fields describe current context. Empty windows stay empty. Scan returns effective dates, a matched count and truncation flag, with at most 100 events per page. Continue with cursor until it is null; truncated may still be true on the last page because it compares the total with that page’s size. Omit dates/phase on continuation or repeat the effective values; changing filters requires a fresh query. Expired windows are errors, never a way into history. Results can change between pages; restart polling from the first page and deduplicate by event id. Known company/entity/event queries retain their existing historical context.
Parsed text is available for filings dated at most seven Beijing calendar days ago (eight dates including today), in chunks of up to 50,000 characters. Source documents may be only partly parsed: reaching the last stored chunk does not mean the full PDF was parsed. Use the source PDF whenever you need the complete original.
Coverage
Four structured event types, with broader company-filing and source-document access. The coverage endpoint states the current scope and limits.
Type | Folded into |
Share reduction by major shareholders | The plan that is still live, and how much of its cap is used up |
Administrative penalty proceedings | Each case grouped by case number, folded to its current stage |
Exchange inquiry letters | Received / replied / overdue — the state of the conversation |
Ordinary A-share trading halts and resumptions | Individual halt cycles, reasons and dates, available through event details and recent discovery |
Company folded state covers reductions, penalties and regulatory letters. Stock halt cycles are available through filings, event details and scans; they are not folded into company state. Convertible-bond and preferred-share halts are outside this scope.
Call list_coverage for the authoritative, always-current answer.
Two things worth knowing
Empty is not the same as unknown. A company with no filings of a type comes back as covered, nothing found — not as an empty result. A security we do not carry comes back as not found, with a reason. Telling those two apart is the point of this service.
We report, we do not judge. Objective extractions only: no ratings, no scores, no attribution of price moves. What you build on top of the facts is yours.
Status
Pre-release. Coverage is narrow and stated honestly; the API may change.
If you are using it and something is missing or wrong, we want to hear it —
tell us here or email contact@astockevent.com.
About this repository
This repo is the public front door: what the server is, how to connect, and the
server.json descriptor for the MCP registry.
The server itself is remote — you point a client at a URL rather than installing code — so there is no server implementation to publish here. Extraction engines, crawlers and schemas live in a private repository.
License
MIT — see LICENSE.
Available Tools
16 toolsget_event_detailARead-onlyIdempotentInspect
Get the full detail for a single event by its event_id. Returns ALL fields: event metadata, structured_payload (quantitative fields specific to the event type), quantitative_tags, confidence_reasons, source info, timeline array, related events, and ai_summary. Use when: you have an event_id and need the complete event record — including type-specific fields in structured_payload that are not shown in list/search results. Do NOT use when: you only need the timeline (use get_event_timeline), or when you want to browse/search (use search_events_by_stock/type). Returns a single event object with all fields, or null if not found.
Inputs: event_id (required).
get_event_timelineARead-onlyIdempotentInspect
Get the lifecycle timeline and full detail for a single event. Tracks the event through its lifecycle: plan → in_progress → completed/terminated. Returns: full event detail + timeline array (each entry has date, phase, description) + related event IDs. Use when: you want to see the phase transitions and lifecycle history of an event you already know the event_id for. Do NOT use when: you want to search or browse events (use search_events_by_stock/type), or when you only need the summary fields (search_events_by_stock already returns ai_summary and key fields). Returns a single event object with timeline, or null if event_id is invalid or not found.
Inputs: event_id (required).
get_trust_reportARead-onlyIdempotentInspect
Get a trust and verification report for a single event. Returns: confidence_tier + confidence_score (heuristic 0-1), multi-source cross-validation details (which sources agree/disagree), and extraction quality metrics from the review system (regex vs LLM conflict count, llm_validation status, whether human-reviewed). Use when: you need to assess how reliable or trustworthy an event's extraction is — e.g. before making a trading decision based on the event data. Do NOT use when: you only need the event data itself (use get_event_detail), or when browsing/searching (use search_events_by_* tools). Returns a trust report object: {event_id, confidence_tier, confidence_score, confidence_reasons, cross_validation: {sources_checked, sources_agree, sources_disagree, source_details}, extraction_quality: {total_fields_reviewed, regex_llm_conflicts, llm_validation, human_reviewed}}.
Inputs: event_id (required).
get_upcoming_eventsARead-onlyIdempotentInspect
Get events due within the next N days — early warning for expirations and deadlines. Covers: lockup share expiration dates (限售股解禁到期), share reduction plan deadlines (减持计划到期), delisting period end dates (退市整理期结束), buyback implementation deadlines (回购实施到期), and regulatory letter reply deadlines (监管函回复截止日). Each result includes: event_id, event_type, stock_code, stock_name, due_date (ISO 8601 date, YYYY-MM-DD), days_remaining (integer countdown), and ai_summary. Use when: you need a forward-looking calendar — what lockup expirations, regulatory deadlines, or buyback periods are ending soon. Do NOT use when: you need historical event data or events without a future due date (use search_events_by_stock/type for general event queries). Returns a JSON array of upcoming events, ordered by due_date ascending (soonest first). Max look-ahead: 30 days. Only events with status=active|updating are included.
Inputs: stock_codes, days, event_types.
search_cb_eventsARead-onlyIdempotentInspect
Search convertible bond events (可转债事件). Covers: call_redemption (强赎/提前赎回), put_resale (回售), conversion_price_down (下修转股价), maturity (到期兑付). Each event includes: cb_name (可转债名称), cb_event_type (子事件类型), and type-specific quantitative fields like redemption_price, event_price, old_conversion_price/new_conversion_price, event_date, etc. Use when: you want convertible bond corporate action signals — forced redemption deadlines (强赎), put-back rights (回售), conversion price adjustments (转股价修正), or maturity redemption. Convertible bond events are a differentiated product — this tool provides the dedicated entry point for this event category. Returns: {data: [...], cursor: <next_cursor_or_null>, has_more: bool}.
Inputs: stock_codes, cb_event_type, status, cursor, +1 more.
search_dividend_eventsARead-onlyIdempotentInspect
Search dividend events (分红/送转). Pre-filtered to dividend. Use for dividend announcements, ex-rights dates, payout ratios.
Inputs: stock_codes, status, cursor, limit.
search_eventsARead-onlyIdempotentInspect
Universal event search with all supported filters. This is the escape hatch for complex queries not covered by the specialized tools. Supports all filter combinations: stock_code, event_type, since (datetime), status, confidence_tier, shareholder_name. Use when: you need a multi-filter query that doesn't fit into the specialized tools — e.g. 'all verified share_reduction events for 002272 since 2026-05-01'. Do NOT use when: a specialized tool (search_events_by_stock, search_events_by_type, search_events_by_shareholder) would work — prefer specialized tools for better results. Supports cursor-based pagination. Returns: {data: [...], cursor: <next_cursor_or_null>, has_more: bool}.
Inputs: stock_codes, event_types, event_type, severity, +7 more.
search_events_by_stockARead-onlyIdempotentInspect
Query structured A-share announcement events by stock code(s). Returns events for: share_reduction (减持), delisting_risk (ST/退市), regulatory_letter (监管函/问询函), lockup_expiration (限售解禁), share_buyback (回购). Each event includes: event_id, event_type, stock_code, stock_name, ai_summary, confidence_tier, structured_payload, and announcement_date. Use when: you know the stock code(s) and want to check recent events for those stocks. Use this for portfolio monitoring, watchlist scanning, or single-stock deep dives. Do NOT use when: you want to search by event type across all stocks (use search_events_by_type), or when you need a specific shareholder's events (use search_events_by_shareholder). Supports cursor-based pagination — use the cursor field in the response to fetch the next page. Returns: {data: [...], cursor: <next_cursor_or_null>, has_more: bool}.
Inputs: stock_codes (required), status, confidence_tier, cursor, +1 more.
search_events_by_typeARead-onlyIdempotentInspect
Query structured A-share announcement events by event type(s). Event types: share_reduction, delisting_risk, regulatory_letter, lockup_expiration, share_buyback. Use when: you want to find all events of a specific type across the market — e.g. all recent share reductions, all ST/delisting warnings, all regulatory letters. Do NOT use when: you know the stock code(s) (use search_events_by_stock), or when you need a complex multi-filter query (use search_events). Supports cursor-based pagination — use the cursor field in the response to fetch the next page. Returns: {data: [...], cursor: <next_cursor_or_null>, has_more: bool}.
Inputs: event_types (required), status, confidence_tier, cursor, +1 more.
search_fund_eventsARead-onlyIdempotentInspect
Search fund penetration events — cross-reference a fund's underlying stock holdings with AStockEvent structured events. Returns a weighted event feed sorted by impact_score = weight_pct × severity_weight. Covers all 13 A-share event types: share_reduction, delisting_risk, regulatory_letter, lockup_expiration, share_buyback, asset_restructuring, trading_halt_resume, pledge_risk, earnings_forecast, share_increase, dividend, violation_penalty, cb_event. Use when: you have a fund code and want to know what events happened to its underlying holdings — e.g. monitoring FOF portfolio risk, fund due diligence, or checking 'did my fund's heavy-weight stocks have any regulatory issues recently?'. Each event includes: stock_code, stock_name, weight_pct, event_type, event_summary, impact_score, severity_weight, confidence_tier. The response includes fund_info, holdings list, events sorted by impact_score DESC, a summary with total_events/affected_holdings_count/affected_weight_pct/top_risk, and a data_freshness disclaimer noting holdings are from the latest quarterly report. Free tier: Top 10 holdings only. Paid REST tier: full holdings + extended lookback.
Inputs: fund_code (required), event_types, days, min_weight.
search_regulatory_eventsARead-onlyIdempotentInspect
Search regulatory events (监管函/问询函). Covers regulatory_letter, violation_penalty. Use for regulatory scrutiny signals from exchanges.
Inputs: stock_codes, status, cursor, limit.
search_restructuring_eventsARead-onlyIdempotentInspect
Search asset restructuring events (重大资产重组). Use for M&A, asset injections, spin-offs, reverse mergers.
Inputs: stock_codes, status, cursor, limit.
search_risk_eventsARead-onlyIdempotentInspect
Search risk events (ST/退市风险/质押风险/停复牌/限售解禁). Covers delisting_risk, pledge_risk, trading_halt_resume, lockup_expiration. Use for early warning signals.
Inputs: stock_codes, status, cursor, limit.
search_violation_eventsBRead-onlyIdempotentInspect
Search violation & penalty events (违规处罚/立案调查). Use for regulatory violations, investigations, penalties, fines.
Inputs: stock_codes, status, cursor, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Most tools have clearly distinct purposes, with specialized search tools for different event types. However, some overlap exists between search_risk_events, search_regulatory_events, and search_violation_events, which cover similar risk-related events.
Naming follows a consistent pattern: 'get_' for retrieval of specific items and 'search_' for querying, with descriptive suffixes like '_by_stock', '_by_type', or category names like '_cb_', '_dividend_'. There is no mixing of conventions.
16 tools is slightly on the higher side but appropriate for the breadth of event types covered. The specialized search tools reduce cognitive load by pre-filtering, and the generic search_events serves as an escape hatch.
The tool surface is comprehensive for querying a wide range of A-share events, including specialized searches and detail retrieval. Missing are creation, update, or delete operations, which may be out of scope for a read-only data server.
Maintenance
Related MCP Connectors
China A-share market data for research, backtesting and AI agents via MCP.
China A-share screening, filings, holdings, flows and calendars as agent tools.
China A-share & equity research MCP server (回声投研) for market quotes, filings, financials, fund flows, concepts & sentiment.
Financial data and research MCP for US/CN/JP equities: filings, statements, ownership, signals.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides 11 MCP tools for querying A-share market data, financial reports, stock screening, hot topics, self-selected stocks, and LOF arbitrage using natural language, powered by East Money / Miaoxiang APIs.MIT
- AlicenseAqualityDmaintenanceMCP server for discovering, downloading, parsing, and searching Hong Kong listed company announcements from HKEXnews through 6 structured tools.647 PyPI4MIT
- AlicenseAqualityDmaintenanceDeterministic A-share morning brief service exposing MCP tools to generate full market briefs, filtered news events, previous close context, and news coverage without external LLM keys.4Apache 2.0
- AlicenseNot gradedqualityCmaintenanceProvides 11 composable MCP tools for A-share market research, covering quotes, news, technical signals, sector performance, portfolio risk, backtesting, and paper trading, with traceable data sources and calculation basis.MIT