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.
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.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file astockevent-0.3.0.tar.gz.
File metadata
- Download URL: astockevent-0.3.0.tar.gz
- Upload date:
- Size: 5.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3c00c6d6ea53d1ebdb8739f130ffe27417a9e90d3458ffc6dd94e02da3d6e7a5
|
|
| MD5 |
6a35fdeaa2fe2fa727aa61e7630e40d7
|
|
| BLAKE2b-256 |
8f65998ef9fbfe3d2438081d2d542e10f502e7c13fd339616cb5b5a1dff102a4
|
File details
Details for the file astockevent-0.3.0-py3-none-any.whl.
File metadata
- Download URL: astockevent-0.3.0-py3-none-any.whl
- Upload date:
- Size: 5.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
dfea35434b153b6706708c626377ed4f2e337ccacac1d32072546ea07825f1e2
|
|
| MD5 |
81b22ad5de075787d220a6329cd9a552
|
|
| BLAKE2b-256 |
db1eda6fecf0151212f58cd51acbba9fdf9dd8c26203cf4dffb69f07c46addd0
|