{"name":"com.astockevent/astockevent","slug":"astockevent","title":"AStockEvent","description":"A-share filings: reductions, penalties, regulatory letters and stock halts. Source-linked facts.","url":"https://mcp.market/server/astockevent","rating":null,"grade":"A","score":87,"certified":false,"status":"active","category":"finance","tags":["finance"],"presence":{"score":26,"stars":1,"forks":0,"downloads_week":null,"last_push_at":"2026-10-21T11:52:09.000Z","license":"MIT"},"uptime":{"percent":32,"checks":28,"ok":9,"last_checked_at":"2026-11-04T07:00:26.474Z","last_ok_at":"2026-11-04T07:00:26.474Z","latency_ms":1309},"claimed":false,"transport":"remote","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/NengjiangLunpi/astockevent-mcp","website":"https://astockevent.com","version":"0.1.0","remotes":[{"type":"streamable-http","url":"https://astockevent.com/mcp/"}],"packages":[],"tools":[{"name":"get_entity_state","description":"Return what is true RIGHT NOW about one A-share listed company or one shareholder entity, folded from its regulatory filings: pending and executed share-reduction plans, administrative-penalty proceedings, and exchange inquiry letters. Call this when you need the current situation of a specific subject — for example 'is this shareholder still selling', 'is this company under investigation', 'has it replied to the inquiry letter'.\n\nDo NOT call this to find out what happened across the market recently — use scan_recent_events or whats_new for that. Do NOT pass both (code, market) and aent_; pick one addressing mode.\n\nRead the response in this order and stop at the first match: (1) found=false -> we do not cover this security/entity, do not retry; (2) visibility='hidden_unverified' -> the entity exists but its identity is not human-verified, so its name is withheld; query by code+market instead; (3) resolved_as='listed_company' -> your aent_ denoted the company itself and the request was redirected, use the returned code/market; (4) has_events=false -> the security EXISTS but had no covered filings in the covered period (this is the common case, ~85% of valid lookups) — report 'no filings in period', never 'company not found'; (5) companies=[...] -> a shareholder active across one or more companies, read each entry; (6) otherwise the state machines apply to that one company.\n\nFields that separate 'did not happen' from 'we do not know' are load-bearing: current_holding_reason, window_status ('expired_no_closure' = the plan window lapsed with no closing filing), entity_link, entities_status, plan_pairing ('unresolved' = several open plans and we refuse to guess the pairing), and unclassified_count. Never collapse them into 'nothing there'. Values are objective extractions with a source PDF link; we never rate, score or attribute.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Security code, e.g. '000029'. Must be given together with market.","title":"Code"},"market":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"One of ['SH', 'SZ', 'BJ']. Required when code is given.","title":"Market"},"aent_":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Opaque entity id taken from a previous response. Never construct or guess one. Mutually exclusive with code/market.","title":"Aent"},"locale":{"default":"en","description":"Language of human-readable data labels only; errors and this description are always English.","enum":["en","zh"],"title":"Locale","type":"string"}},"title":"get_entity_stateArguments"}},{"name":"get_event_with_context","description":"Return one specific filing event together with its full timeline (every stage the case went through, each with its own source PDF) and which subject's state it changed. Call this after another tool handed you an event id and you need the whole thread rather than a one-line summary — for example to see how a penalty case progressed from filing to decision.\n\nDo NOT call this without an event id from a previous response: ids are opaque and cannot be guessed or constructed. Internal database identifiers are rejected.\n\naffects_state lets you jump back to get_entity_state. Its subjects[].aent_ may be null when entity resolution has not run yet or does not apply — in that case use the code and market from the same affects_state, which never depends on entity resolution. If the id is unknown you get found=false, which is an answer, not an error: do not retry.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"aevt":{"description":"Opaque event id from a previous response. Must start with 'aevt_'.","title":"Aevt","type":"string"},"locale":{"default":"en","description":"Language of data labels only.","enum":["en","zh"],"title":"Locale","type":"string"}},"required":["aevt"],"title":"get_event_with_contextArguments"}},{"name":"get_filing_parsed","description":"Return ONE filing already parsed for you: its available normalised text and its tables as structured cells. Call it after list_company_filings, with the `aann_` id that tool returned, when you need what a filing actually says rather than just its title and PDF link.\n\nThis is the step your own pipeline would otherwise have to do: a filing PDF is a layout format, not a data format, so pulling clean text and real table cells out of it is where ad-hoc extraction usually goes wrong. Tables come back as rows of cells you can read directly, not as an image or a flattened blob.\n\nIt serves ONE filing per call, whose date is at most seven days before the database current date (eight calendar dates including today). Older filings are not gone — the filing itself and its source PDF link stay available from list_company_filings for the company's whole history; only the parsed text is recent-only. When that is why you got nothing, `reason` says outside_parsed_window, which is a different answer from unknown_filing.\n\nSource coverage is limited: PDFs over 150 pages are parsed only through the first 30 pages; table coverage is limited above 50 pages. Use source links for the complete original. text_chars measures stored text, not source completeness. text_truncated=false or next_text_offset=null does not mean every PDF page was parsed.\n\nStored text arrives in slices: read `text_chars` for the stored total and call again with `next_text_offset` until it is null. Do NOT use this to sweep a company or the market — it takes a single filing id and has no cursor.\n\nRead `text_unavailable` before trusting the text. Two of its values are properties of the source file — a scan with no text layer, or a font we cannot map to Unicode — and retrying those will not help. A third, parse_failed, means the failure is ours rather than the document's, and asking again later may well work. Either way the source links are still worth opening.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"aann_":{"description":"Opaque filing id from list_company_filings, e.g. aann_Kyw46MM1gCnIaBxA.","title":"Aann","type":"string"},"text_offset":{"default":0,"description":"0-based offset into the filing's full text. Start at 0; then pass next_text_offset from the previous call.","title":"Text Offset","type":"integer"}},"required":["aann_"],"title":"get_filing_parsedArguments"}},{"name":"get_passage","description":"Read a citation returned by the selected deal, with neighbouring source paragraphs.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"deal":{"title":"Deal","type":"string"},"run":{"title":"Run","type":"integer"},"document":{"title":"Document","type":"string"},"block":{"title":"Block","type":"string"},"build":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Build"}},"required":["deal","run","document","block"],"title":"get_passageArguments"}},{"name":"get_related_filings","description":"Return the other filings this filing cites. Call it after list_company_filings or get_filing_parsed, with the `aann_` id they returned, when you need the paper trail around a filing rather than the filing alone.\n\nChinese listed companies print a filing number on most of their filings (e.g. 2026-047) and later filings cite it in their text. This tool follows those citations. Matching is exact and scoped to the same company — those numbers are per-company yearly counters and collide across the market, so a cross-company match would be wrong, not merely noisy.\n\nUnlike get_filing_parsed this has NO recency window: you can ask about a filing of any age. What comes back is title, date and id, so you can feed any `aann_` straight back into get_filing_parsed — that step is the one limited to recent filings.\n\nRead the empty case carefully, because two different facts look similar. found=false means we hold no such filing id. found=true with an empty `related` means we do hold it and it cites nothing we have. `own_number` tells you the other half of the story: when it is null, this filing prints no number of its own, so nothing can cite it either. About a third of filings carry no printed number, so an empty result is ordinary rather than a sign of missing data.\n\nWHERE COVERAGE ENDS: every filing whose text we hold has been scanned for citations, so an empty `related` on those is a real answer, not a gap. What is still incomplete is the corpus itself — a sizeable part of the archive is crawled but not yet parsed, and a filing we have not parsed cannot appear on either side of a citation. So a cited filing may be missing simply because we have not processed it yet, which is also why `matched_no` is worth reading: it names the number that was cited, even when we can only resolve some of them.\n\n`aevt_` on an entry is null when the cited filing produced no event. That is normal: we extract only a few event types so far (list_coverage names them), and the citation link itself does not depend on extraction.\n\nDo NOT use this to sweep a company or the market: it takes a single filing id, has no cursor, and follows citations one hop at a time. Do NOT expect the cited filing's text here either — this returns identity only; pass the `aann_` to get_filing_parsed for text, and note that step does have a recency window.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"aann_":{"description":"Opaque filing id from list_company_filings, e.g. aann_Kyw46MM1gCnIaBxA.","title":"Aann","type":"string"},"limit":{"default":20,"description":"Max related filings to return. See limits.related_limit_max.","title":"Limit","type":"integer"}},"required":["aann_"],"title":"get_related_filingsArguments"}},{"name":"get_timeline","description":"Read source mentions by filing date (YYYY-MM-DD), including coverage and qualifiers.\n\n        Omit build for current results; explicit build requests historical results.\n        Repeated mentions are not newly occurring events or notification changes.\n        ","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"deal":{"title":"Deal","type":"string"},"start":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Start"},"end":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"End"},"build":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Build"}},"required":["deal"],"title":"get_timelineArguments"}},{"name":"list_company_filings","description":"List the most recent filings of ONE listed company: title, date, a direct link to the source PDF, and — where we have it — the structured extraction that filing produced. Call this to answer 'what has this company filed lately' and 'give me the original document', which is what most callers actually want before any analysis.\n\nThis is the widest view we offer: it covers EVERY filing we hold for the company, not just the ones we extract.\n\nDo NOT use it to ask what a case or a plan currently amounts to — it returns documents in date order, not folded state; get_entity_state does that. Do NOT use it to sweep the market for one filing type across companies (scan_recent_events), and do NOT page through it for bulk export: it has no cursor and stops at 50 rows per call.\n\nRead with_extraction: most filings have none, because we extract a focused set of filing types — call list_coverage for the ones we support today. `extraction: null` means we have not extracted that filing — it never means the filing is unimportant. When extraction is present, pass its aevt_ to get_event_with_context for the full case timeline.\n\nTitles are returned in the original Chinese, unchanged — translating a filing title would be rewriting the fact. There is no cursor: this is a recent-filings view, not a bulk export.\n\n`published_at` is null for most filings: it is present only when the source itself supplied a timestamp, and we do not substitute our own collection time for it. Use ann_date, which is always present, for the filing date.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"code":{"description":"Six-digit A-share ticker, e.g. 000029.","title":"Code","type":"string"},"market":{"description":"Which exchange the ticker belongs to.","enum":["SH","SZ","BJ"],"title":"Market","type":"string"},"limit":{"default":20,"description":"1..50. Default 20.","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"required":["code","market"],"title":"list_company_filingsArguments"}},{"name":"list_coverage","description":"Return exactly what this server covers and the limits it enforces. Call this first, or whenever a query comes back empty and you want to know whether the filing type is even in scope, before concluding the data is incomplete.\n\nIt takes no arguments and does not touch the database, so it works even when everything else is degraded. Coverage is deliberately narrow and expanding over time; the `event_types` list in the response is the authoritative answer, and stating it plainly is preferable to letting you discover the boundary by trial and error. Read `limits` instead of probing for the caps.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"title":"list_coverageArguments"}},{"name":"list_deals","description":"Find astockevent acquisitions by name, verified ticker/alias or CIK; not all-market search.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"query":{"default":"","title":"Query","type":"string"}},"title":"list_dealsArguments"}},{"name":"scan_recent_events","description":"Discover one filing event type across companies using linked filing dates within the last seven Beijing calendar days including today. Dates omitted use this whole window; one omitted end uses the corresponding allowed boundary. Partial overlap is clamped; reversed or wholly outside dates are errors. effective_since/effective_until report the actual dates. A new filing mentioning an old case qualifies without claiming new case progress.\n\nCall this for market-wide recent filings. Do NOT use it for a full company state. Each event appears once, newest matching filing date first. matched_filing contains the qualifying filing id, date and its own PDF link; root source_pdf_url and phase describe current event context, not historical state at the selected date. phase filters current stage. At most 100 events per page. Pass cursor to continue; only non-null cursor means another page. Omit dates/phase on continuation or repeat their effective values; changing filters requires a fresh call. event_type must remain the same; limit/locale may change. matched_count counts the whole frozen window, so truncated can remain true on the last page. Windows that move outside the allowed dates fail with cursor_expired; restart without cursor. Results are a dynamic view, not a snapshot: new filings, stage changes or merges can move events between pages. Poll from the first page and deduplicate by aevt_. Empty results mean no matches after this position, not an empty database. coverage_since is data coverage, not permission to scan history. For a known company/entity use get_entity_state; for a known event use get_event_with_context.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"event_type":{"description":"Which filing type to scan. Call list_coverage for the current scope.","enum":["share_reduction","violation_penalty","regulatory_letter","trading_halt_resume"],"title":"Event Type","type":"string"},"since":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Inclusive start date, YYYY-MM-DD.","title":"Since"},"until":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Inclusive end date, YYYY-MM-DD (the whole day counts).","title":"Until"},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Restrict to one stage of the case. Must belong to the chosen event_type; the error message lists the valid values.","title":"Phase"},"limit":{"default":50,"description":"1..100. Default 50.","maximum":100,"minimum":1,"title":"Limit","type":"integer"},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Return the previous cursor unchanged to continue within its frozen dates.","title":"Cursor"},"locale":{"default":"en","description":"Language of data labels only.","enum":["en","zh"],"title":"Locale","type":"string"}},"required":["event_type"],"title":"scan_recent_eventsArguments"}},{"name":"whats_new","description":"Discover events with a linked filing dated within the last seven Beijing calendar days including today, and updated in the last seven days. A new filing may mention an old case; this does not imply new case progress. matched_filing gives the filing date and PDF that qualified the event; root source_pdf_url, phase and payload describe current event context. announce_ts remains the original first disclosure.\n\nCall this to follow recent disclosures. Do NOT use it for unrestricted history. Poll from the top and deduplicate event ids. To page backwards pass both cursor and cursor_aevt verbatim; these use processing time, not filing dates. Old cursors restart at the current window with clamped=true. Concurrent updates can move results between pages. end_of_window=true means no further results, including an empty first call; empty results are successful and do not prove the database is empty or ingestion is healthy. fallback_recent is always false: history never fills an empty window. Use a known company, entity or event for historical context.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The `cursor` value from a previous response, passed back verbatim.","title":"Cursor"},"cursor_aevt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The `cursor_aevt` value from the same response. Required together with cursor for correct paging.","title":"Cursor Aevt"},"limit":{"default":50,"description":"1..100. Default 50.","maximum":100,"minimum":1,"title":"Limit","type":"integer"},"locale":{"default":"en","description":"Language of data labels only.","enum":["en","zh"],"title":"Locale","type":"string"}},"title":"whats_newArguments"}}],"scan":{"score":87,"grade":"A","scanned_at":"2026-11-03T14:20:15.757Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-11-03T14:20:15.619Z","components":{"code":{"score":-1,"max":25,"notes":["remote-only server, no package to scan"]},"reliability":{"score":17,"max":20,"notes":["remote reachable in 2715ms"]},"poisoning":{"score":15,"max":15,"notes":["3 tool descriptions checked"]},"auth":{"score":10,"max":15,"notes":["open endpoint, read-only tools"]},"maintenance":{"score":15,"max":15,"notes":["last push 13 days ago"]},"identity":{"score":8,"max":10,"notes":["endpoint served from the registry-verified namespace domain"]}},"findings":[],"inputs":{"probes":[{"url":"https://astockevent.com/mcp/","reachable":true,"authRequired":false,"latencyMs":2715,"serverInfo":{"name":"astockevent","version":""}}],"packages":[],"repo":{"found":true,"owner":"NengjiangLunpi","repo":"astockevent-mcp","archived":false,"pushedAt":"2026-10-21T11:52:09Z","stars":1,"forks":0,"openIssues":0,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/227519142?v=4","ownerCreatedAt":"2025-08-20T03:57:52Z","license":"MIT"},"icon":{"url":null,"source":"none"},"presence":{"stars":1,"forks":0,"downloadsWeek":null,"license":"MIT","lastPushAt":"2026-10-21T11:52:09.000Z","score":26}}}},"grade_history":[{"kind":"restore","fromGrade":"D","toGrade":"A","reason":"score 87","createdAt":"2026-11-03T14:20:17.182Z"},{"kind":"downgrade","fromGrade":"B","toGrade":"D","reason":"score 47: Remote endpoint did not respond","createdAt":"2026-10-28T18:33:02.437Z"}],"reviews":[]}