Skip to main content
Glama
AStockEvent

AStockEvent

AStockEvent — MCP server for Chinese A-share regulatory filings

License: MIT MCP

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

list_coverage

What is in scope and what the limits are. Call this before concluding data is missing.

list_company_filings

Filings held for one company, with source links and any extracted events; up to 50 per call, without list pagination.

get_filing_parsed

Available parsed text and tables for one recent filing; long documents may be partial.

get_related_filings

Collected filings of the same company matched by explicit document references.

get_entity_state

Folded company state, or linked companies for a confirmed actor identifier.

get_event_with_context

One event plus its whole timeline, in a single call.

whats_new

Events updated within seven days and linked to filings from the last seven Beijing calendar days, cursor-paged.

scan_recent_events

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 tools
get_event_detailA
Read-onlyIdempotent
Inspect

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_timelineA
Read-onlyIdempotent
Inspect

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_reportA
Read-onlyIdempotent
Inspect

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_eventsA
Read-onlyIdempotent
Inspect

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_eventsA
Read-onlyIdempotent
Inspect

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_eventsA
Read-onlyIdempotent
Inspect

Search dividend events (分红/送转). Pre-filtered to dividend. Use for dividend announcements, ex-rights dates, payout ratios.

Inputs: stock_codes, status, cursor, limit.

search_eventsA
Read-onlyIdempotent
Inspect

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_shareholderA
Read-onlyIdempotent
Inspect

Query events by shareholder name. Searches across all event types where the shareholder name appears in structured_payload. Most useful for: share_reduction (减持) events where shareholder_name is a top-level field in structured_payload. Use when: you want to track a specific shareholder's activity — e.g. '罗丽华' or '国家集成电路产业投资基金'. Do NOT use when: you want all events for a stock (use search_events_by_stock), or when you're unsure of the exact shareholder name (use search_events with keyword in ai_summary). Returns: {data: [...], cursor: <next_cursor_or_null>, has_more: bool}.

Inputs: shareholder_name (required), cursor, limit.

search_events_by_stockA
Read-onlyIdempotent
Inspect

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_typeA
Read-onlyIdempotent
Inspect

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_eventsA
Read-onlyIdempotent
Inspect

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_eventsA
Read-onlyIdempotent
Inspect

Search regulatory events (监管函/问询函). Covers regulatory_letter, violation_penalty. Use for regulatory scrutiny signals from exchanges.

Inputs: stock_codes, status, cursor, limit.

search_restructuring_eventsA
Read-onlyIdempotent
Inspect

Search asset restructuring events (重大资产重组). Use for M&A, asset injections, spin-offs, reverse mergers.

Inputs: stock_codes, status, cursor, limit.

search_risk_eventsA
Read-onlyIdempotent
Inspect

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_shareholder_eventsA
Read-onlyIdempotent
Inspect

Search shareholder behavior events (减持/增持/回购/质押). Covers share_reduction, share_increase, share_buyback, pledge_risk. Use for insider signals.

Inputs: stock_codes, status, cursor, limit.

search_violation_eventsB
Read-onlyIdempotent
Inspect

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

    A3.9/5.0

    Scored across 16 tools

    Disambiguation4/5

    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 Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for discovering, downloading, parsing, and searching Hong Kong listed company announcements from HKEXnews through 6 structured tools.
      6
      47 PyPI
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Deterministic 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.
      4
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides 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