Skip to main content

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.

Claude Desktop / any client that takes a remote URL
{
  "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.


Tools

Tool What it answers
list_coverage What is in scope and what the limits are. Call this before concluding data is missing.
get_entity_state Folded state for a company, or for a shareholder across every company they touch.
get_event_with_context One event plus its whole timeline, in a single call.
whats_new What changed recently, cursor-paged.
scan_recent_events Cross-company scan by filing type and date range.

Coverage

Three filing types today, stated plainly — more are being added. We would rather tell you the boundary than let you discover it by trial and error.

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

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.

Metadata

Release files for astockevent 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for astockevent 0.3.0
File Size Uploaded Provenance Actions
astockevent-0.3.0.tar.gz 5.5 kB Without provenance Details for astockevent-0.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for astockevent 0.3.0
File Interpreter ABI Platform Actions
astockevent-0.3.0-py3-none-any.whl Python 3 none any Details for astockevent-0.3.0-py3-none-any.whl

Total release size: 10.8 kB

Release files / astockevent-0.3.0.tar.gz

Download URL astockevent-0.3.0.tar.gz
Size 5.5 kB
Tags Source
SHA-256 checksum
How to use checksums
3c00c6d6ea53d1ebdb8739f130ffe27417a9e90d3458ffc6dd94e02da3d6e7a5
BLAKE2b-256 checksum
How to use checksums
8f65998ef9fbfe3d2438081d2d542e10f502e7c13fd339616cb5b5a1dff102a4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / astockevent-0.3.0-py3-none-any.whl

Download URL astockevent-0.3.0-py3-none-any.whl
Size 5.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dfea35434b153b6706708c626377ed4f2e337ccacac1d32072546ea07825f1e2
BLAKE2b-256 checksum
How to use checksums
db1eda6fecf0151212f58cd51acbba9fdf9dd8c26203cf4dffb69f07c46addd0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for astockevent 0.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page