CaseMagic — Court Case Monitor

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": {
    "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."
    },
    "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."
    },
    "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
}

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": {
    "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."
    },
    "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."
    }
  },
  "additionalProperties": false
}

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": {
    "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."
    },
    "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."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "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."
    }
  },
  "additionalProperties": false
}

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": {
    "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."
    },
    "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."
    },
    "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
}

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": {
    "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."
    },
    "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."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "How many documents to return, newest first. Defaults to 20."
    }
  },
  "additionalProperties": false
}

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": {
    "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."
    },
    "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."
    }
  },
  "additionalProperties": false
}

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",
  "properties": {
    "connect_token": {
      "type": "string",
      "description": "The connect_token returned by find_federal_case for the case the user confirmed."
    },
    "user_role": {
      "type": "string",
      "enum": [
        "plaintiff",
        "defendant",
        "attorney",
        "other"
      ],
      "description": "The user's own role in the case. Ask them rather than guessing."
    }
  },
  "required": [
    "connect_token",
    "user_role"
  ],
  "additionalProperties": false
}

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
}

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": {
    "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."
    },
    "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."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "How many items to return. Defaults to 50."
    }
  },
  "additionalProperties": false
}

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
}

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
}

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": {
    "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."
    },
    "after": {
      "type": "string",
      "description": "An ISO-8601 timestamp; only messages received after it are returned."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "How many messages to return. Defaults to 20."
    },
    "query": {
      "type": "string",
      "description": "Plain text matched against sender, subject and body."
    }
  },
  "additionalProperties": false
}

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",
  "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."
    },
    "to": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "description": "Recipient email addresses."
    },
    "cc": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional copied addresses."
    },
    "subject": {
      "type": "string",
      "description": "The subject line."
    },
    "body": {
      "type": "string",
      "description": "The message body, as plain text."
    }
  },
  "required": [
    "to",
    "subject",
    "body"
  ],
  "additionalProperties": false
}