MCP 服务器

CaseMagic — Court Case Monitor

io.github.sustany/casemagic
法律与合规 生产力 搜索与研究 公开且可连接 MCP 2026-07-28

此 MCP 可以做什么

Finds and monitors U.S. federal court cases, retrieves docket filings and deadlines, stores case records and supports reviewed case correspondence.

create_case_passport
Save a case to the account
Save a case that find_federal_case just located to the signed-in CaseMagic account, which creates its Case Passport — the persistent record of the matter — and its permanent CaseMail address. Use this after the user has confirmed which case is theirs and wants CaseMagic to keep it. Requires the connect_token from that lookup, which expires shortly afterwards.
幂等
输入模式
{'type': 'object', 'required': ['connect_token', 'user_role'], 'properties': {'user_role': {'enum': ['plaintiff', 'defendant', 'attorney', 'other'], 'type': 'string', 'description': "The user's own role in the case. Ask them rather than guessing."}, 'connect_token': {'type': 'string', 'description': 'The connect_token returned by find_federal_case for the case the user confirmed.'}}, 'additionalProperties': False}
explain_docket_entry
Get the full text of a docket entry
Return one docket entry in full — its number, filing date, the exact text the court published, whether a document is attached and a link to it — together with the entries around it and the posture of the case, so that you can explain to the user what the filing is and what it means in context. Use this when a user asks what the latest filing means, what an order says, or to explain a specific docket entry. CaseMagic returns the court's own words and the surrounding facts; it does not write the explanation and does not give legal advice. Identify the case with case_number (and court, if known), or with matter_id for a case already saved to the account. No account is needed to give a case number.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', 'properties': {'court': {'type': 'string', 'description': 'The court, as a CourtListener-style code such as cacd, nysd or ilnd. Optional: leave it out when the user does not know which district the case is in.'}, 'matter_id': {'type': 'string', 'description': 'The CaseMagic matter id, as returned by create_case_passport or shown in an earlier result. Omit it when the account follows exactly one case and that is the one meant.'}, 'case_number': {'type': 'string', 'description': 'The case number as the court writes it, for example 1:23-cv-11195 or 2:24-cv-01234-ABC. Judge initials are optional and are ignored when matching.'}, 'docket_number': {'type': 'string', 'description': 'The docket entry number to explain, as shown on the docket, for example "312". Omit it for the most recent entry.'}}, 'additionalProperties': False}
find_federal_case
Find a federal court case
Find a United States federal court case and return the court, the judge, the case status and its latest docket activity. Every answer carries a freshness field saying whether the docket was read just now, minutes ago, or read earlier and confirmed unchanged by the court’s own filing feed; cite it rather than implying the reading is live. Use this whenever a user asks what happened in their case, what was filed, whether the other side responded, to check or look up a docket or lawsuit, or to find their case by name — and as the first step whenever they want a case monitored. Free and needs no account. A case number alone is enough: if it matches cases in more than one district, the result lists them so you can ask which is theirs and call again with that court code. Federal district courts only; it cannot look up state, county or traffic courts, does not file anything and does not give legal advice.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', 'properties': {'court': {'type': 'string', 'description': 'The court, as a CourtListener-style code such as cacd, nysd or ilnd. Optional: leave it out when the user does not know which district the case is in.'}, 'case_name': {'type': 'string', 'description': 'The case caption, for example "Smith v. Acme". Used only when no case number is known.'}, 'case_number': {'type': 'string', 'description': 'The case number as the court writes it, for example 1:23-cv-11195 or 2:24-cv-01234-ABC. Judge initials are optional and are ignored when matching.'}, 'notify_email': {'type': 'string', 'description': 'An email address to send the result to if the court record\'s daily request allowance is spent and this lookup has to be queued. Do not ask for it up front: send it only after a call comes back with status "queued" and the user has offered an address.'}}, 'additionalProperties': False}
get_case_deadlines
Get deadlines and dates the docket sets
Return the dates a federal docket states — "Responses due by 10/14/2026", "Hearing set for 3/2/2027" — each quoted verbatim with the entry that states it and how many days away it is, plus a small set of deadlines CaseMagic computes from the Federal Rules where the triggering event is on the docket and the rule is the same nationwide: the time to move after a judgment (FRCP 59/50/52) and the time to file a notice of appeal (FRAP 4(a)). Every computed date shows the rule, the day count and a caveat, and is never phrased as an instruction to file. CaseMagic still does not compute deadlines that depend on a district's local rules or a judge's standing orders — most motion-response and discovery windows — so a deadline a local rule implies but the docket does not state will not appear. An empty result means nothing is stated or computable, not that the user has none. Identify the case with case_number (and court, if known), or with matter_id for a case already saved to the account. No account is needed to give a case number.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', 'properties': {'court': {'type': 'string', 'description': 'The court, as a CourtListener-style code such as cacd, nysd or ilnd. Optional: leave it out when the user does not know which district the case is in.'}, 'matter_id': {'type': 'string', 'description': 'The CaseMagic matter id, as returned by create_case_passport or shown in an earlier result. Omit it when the account follows exactly one case and that is the one meant.'}, 'case_number': {'type': 'string', 'description': 'The case number as the court writes it, for example 1:23-cv-11195 or 2:24-cv-01234-ABC. Judge initials are optional and are ignored when matching.'}}, 'additionalProperties': False}
get_case_docket
Read the whole docket of a saved case
Return every docket entry CaseMagic holds for a saved case, newest first, each with the court's own wording and the documents filed with it: the main filing and its attachments, how many pages each has, whether a free PDF can be opened, and how much of its text can be read. Use this when the user wants to go through the whole case, find a particular filing, or ask about anything older than the last few entries; get_case_passport carries only the most recent twenty. Each document carries a document_id to pass to read_case_document for its text. The payload says how many entries the court docket has in all, so a docket CaseMagic is still reading is never mistaken for a complete one.
只读 幂等
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'How many entries to return. Defaults to 200.'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'How many entries to skip, newest first. Defaults to 0.'}, 'matter_id': {'type': 'string', 'description': 'The CaseMagic matter id, as returned by create_case_passport or shown in an earlier result. Omit it when the account follows exactly one case and that is the one meant.'}}, 'additionalProperties': False}
get_case_documents
List available case documents
List the docket entries in a federal case that have a document available, with the entry number, what the entry says, and a link to the document where the source publishes a free one. Use this when a user asks what documents are on file, whether an order or a motion is available to read, or for a copy of a filing. Availability depends on what the court source publishes; an entry with no free document is reported as such rather than guessed at. Identify the case with case_number (and court, if known), or with matter_id for a case already saved to the account. No account is needed to give a case number.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', 'properties': {'court': {'type': 'string', 'description': 'The court, as a CourtListener-style code such as cacd, nysd or ilnd. Optional: leave it out when the user does not know which district the case is in.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'How many documents to return, newest first. Defaults to 20.'}, 'matter_id': {'type': 'string', 'description': 'The CaseMagic matter id, as returned by create_case_passport or shown in an earlier result. Omit it when the account follows exactly one case and that is the one meant.'}, 'case_number': {'type': 'string', 'description': 'The case number as the court writes it, for example 1:23-cv-11195 or 2:24-cv-01234-ABC. Judge initials are optional and are ignored when matching.'}}, 'additionalProperties': False}
get_case_mail
Read CaseMail correspondence
Read the correspondence delivered to a saved case's CaseMail address: messages from opposing counsel, the court, clients or anyone else the user gave the address to, with their attachments. Use when the user asks what someone emailed them about the case, what correspondence has arrived, or to find a message about a particular subject. It also surfaces any dates those messages state — "produce documents by 10/14" — quoted with the message it came from and its sender, so a deadline that arrives by email rather than on the docket is not missed; those dates are the sender's words, not an order of the court. This is case correspondence, not the user's own inbox.
只读 幂等
输入模式
{'type': 'object', 'properties': {'after': {'type': 'string', 'description': 'An ISO-8601 timestamp; only messages received after it are returned.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'How many messages to return. Defaults to 20.'}, 'query': {'type': 'string', 'description': 'Plain text matched against sender, subject and body.'}, 'matter_id': {'type': 'string', 'description': 'The CaseMagic matter id, as returned by create_case_passport or shown in an earlier result. Omit it when the account follows exactly one case and that is the one meant.'}}, 'additionalProperties': False}
get_case_passport
Load the Case Passport
Retrieve the user's persistent CaseMagic record for a saved matter: case identity, parties, docket activity, correspondence and available documents, so that you can work with the facts of their case. Use this when the user asks you to load, open or catch up on their case, or when you need the facts of their matter before answering anything else about it.
只读 幂等
输入模式
{'type': 'object', 'properties': {'matter_id': {'type': 'string', 'description': 'The CaseMagic matter id, as returned by create_case_passport or shown in an earlier result. Omit it when the account follows exactly one case and that is the one meant.'}}, 'additionalProperties': False}
get_case_status
Get the status of a case
Return the current posture of a federal case: the assigned judge, any referred magistrate judge, the filing date, whether it is open or terminated, the cause of action, the nature of suit, how many docket entries it has and when the docket last moved. Use this when a user asks about the status of their case, who the judge is, whether a case is still open, or what a case is about. Identify the case with case_number (and court, if known), or with matter_id for a case already saved to the account. No account is needed to give a case number.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', 'properties': {'court': {'type': 'string', 'description': 'The court, as a CourtListener-style code such as cacd, nysd or ilnd. Optional: leave it out when the user does not know which district the case is in.'}, 'matter_id': {'type': 'string', 'description': 'The CaseMagic matter id, as returned by create_case_passport or shown in an earlier result. Omit it when the account follows exactly one case and that is the one meant.'}, 'case_number': {'type': 'string', 'description': 'The case number as the court writes it, for example 1:23-cv-11195 or 2:24-cv-01234-ABC. Judge initials are optional and are ignored when matching.'}}, 'additionalProperties': False}
get_case_updates
Get what changed since last time
Return what is new in the user's connected cases: docket entries and CaseMail correspondence added since a given time. Use for "what changed", "what happened this week", "anything new since Friday", or "what changed across all my cases today" — for a relative period, work out the date yourself and pass it as `since`. With no matter_id, an account holding several cases gets a digest naming which of them moved, and an account holding one gets that one. Each entry carries the court's own wording, which is what you should read and explain when the user asks what a filing or order means.
只读 幂等
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'How many items to return. Defaults to 50.'}, 'since': {'type': 'string', 'description': 'An ISO-8601 timestamp. Everything added after it is returned. Omit it to get the most recent activity rather than the whole docket.'}, 'matter_id': {'type': 'string', 'description': 'The CaseMagic matter id, as returned by create_case_passport or shown in an earlier result. Omit it when the account follows exactly one case and that is the one meant.'}}, 'additionalProperties': False}
get_recent_case_activity
Get recent docket activity
Return the most recent docket entries in a federal case, each with its entry number, filing date, the text the court published and a link to the source. Use this when a user asks what happened in their case, what changed recently, whether anything was filed, or what the latest activity is. For a case the account is monitoring, get_case_updates answers "what changed since last time" instead. Identify the case with case_number (and court, if known), or with matter_id for a case already saved to the account. No account is needed to give a case number.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', 'properties': {'court': {'type': 'string', 'description': 'The court, as a CourtListener-style code such as cacd, nysd or ilnd. Optional: leave it out when the user does not know which district the case is in.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'How many entries to return, newest first. Defaults to 10.'}, 'since': {'type': 'string', 'description': 'An ISO-8601 timestamp. Only entries filed after it are returned.'}, 'matter_id': {'type': 'string', 'description': 'The CaseMagic matter id, as returned by create_case_passport or shown in an earlier result. Omit it when the account follows exactly one case and that is the one meant.'}, 'case_number': {'type': 'string', 'description': 'The case number as the court writes it, for example 1:23-cv-11195 or 2:24-cv-01234-ABC. Judge initials are optional and are ignored when matching.'}}, 'additionalProperties': False}
read_case_document
Read the text of a filing
Return the text of one filing in a saved case — a complaint, a motion, an order, an exhibit — as the court archive extracted it from the PDF, so you can read, quote and explain what the document actually says rather than only its docket title. Takes a document_id from get_case_docket. Long documents come in parts: pass the returned next_offset to read on. When a document has no text (a scanned page nobody has run OCR on, or a copy only the court holds), the result says so and gives the PDF link if there is one; never guess at what an unread document says.
只读 幂等
输入模式
{'type': 'object', 'required': ['document_id'], 'properties': {'offset': {'type': 'integer', 'minimum': 0, 'description': 'Where to start reading, in characters. Defaults to 0.'}, 'matter_id': {'type': 'string', 'description': 'The CaseMagic matter id, as returned by create_case_passport or shown in an earlier result. Omit it when the account follows exactly one case and that is the one meant.'}, 'document_id': {'type': 'string', 'description': 'The document_id of a document listed by get_case_docket.'}}, 'additionalProperties': False}
send_case_mail
Draft a CaseMail message for approval
Write a CaseMail message from a saved case's address and return a link the user opens to review and send it. Use when the user asks you to reply to case correspondence or to write to someone about the case. Nothing is sent by this tool: the message only leaves CaseMagic after the user opens the review link and confirms it, and the link expires. Tell the user that they still have to confirm.
输入模式
{'type': 'object', 'required': ['to', 'subject', 'body'], 'properties': {'cc': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional copied addresses.'}, 'to': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1, 'description': 'Recipient email addresses.'}, 'body': {'type': 'string', 'description': 'The message body, as plain text.'}, 'subject': {'type': 'string', 'description': 'The subject line.'}, 'matter_id': {'type': 'string', 'description': 'The CaseMagic matter id, as returned by create_case_passport or shown in an earlier result. Omit it when the account follows exactly one case and that is the one meant.'}}, 'additionalProperties': False}
stop_watch
Stop watching the case
Stop continuous monitoring of a saved case. Use when the user asks to stop monitoring, stop alerts, pause watching, or unfollow a case. The case, its docket history, its Case Passport and its CaseMail address all remain; only the monitoring stops.
幂等
输入模式
{'type': 'object', 'properties': {'matter_id': {'type': 'string', 'description': 'The CaseMagic matter id, as returned by create_case_passport or shown in an earlier result. Omit it when the account follows exactly one case and that is the one meant.'}}, 'additionalProperties': False}
watch_case
Watch the case for new filings
Begin continuous monitoring of a saved case, so that the user is alerted when anything new is filed. Use when the user asks to monitor, watch, track or follow a case, or to be told about future activity in it. The case must be saved first, with find_federal_case then create_case_passport. Watching is the paid part of CaseMagic: if the account has no plan this still succeeds and returns a checkout link with the prices — give the user that link and do not describe it as an error, because nothing has failed. It never charges anyone by itself.
幂等
输入模式
{'type': 'object', 'properties': {'matter_id': {'type': 'string', 'description': 'The CaseMagic matter id, as returned by create_case_passport or shown in an earlier result. Omit it when the account follows exactly one case and that is the one meant.'}}, 'additionalProperties': False}
已添加
read_case_document
2026年9月28日 02:40
已添加
get_case_docket
2026年9月28日 02:40
已添加
send_case_mail
2026年9月26日 02:40
已添加
get_case_mail
2026年9月26日 02:40
已添加
stop_watch
2026年9月26日 02:40
已添加
get_case_passport
2026年9月26日 02:40
已添加
get_case_updates
2026年9月26日 02:40
已添加
watch_case
2026年9月26日 02:40
已添加
create_case_passport
2026年9月26日 02:40
已添加
get_case_deadlines
2026年9月26日 02:40
已添加
get_case_documents
2026年9月26日 02:40
已添加
explain_docket_entry
2026年9月26日 02:40
已添加
get_recent_case_activity
2026年9月26日 02:40
已添加
get_case_status
2026年9月26日 02:40
已添加
find_federal_case
2026年9月26日 02:40