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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

astockevent-0.3.0.tar.gz (5.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

astockevent-0.3.0-py3-none-any.whl (5.3 kB view details)

Uploaded Python 3

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

Hashes for astockevent-0.3.0.tar.gz
Algorithm Hash digest
SHA256 3c00c6d6ea53d1ebdb8739f130ffe27417a9e90d3458ffc6dd94e02da3d6e7a5
MD5 6a35fdeaa2fe2fa727aa61e7630e40d7
BLAKE2b-256 8f65998ef9fbfe3d2438081d2d542e10f502e7c13fd339616cb5b5a1dff102a4

See more details on using hashes here.

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

Hashes for astockevent-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 dfea35434b153b6706708c626377ed4f2e337ccacac1d32072546ea07825f1e2
MD5 81b22ad5de075787d220a6329cd9a552
BLAKE2b-256 db1eda6fecf0151212f58cd51acbba9fdf9dd8c26203cf4dffb69f07c46addd0

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 files

0.2.1

2 files

0.2.0

2 files

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