Skip to main content
Glama

Change a draft case

evictions_update_case
DestructiveIdempotent

Use this when a draft’s facts need correcting or completing, for example after evictions_validate_case says what is missing. Input: the case id and only the fields to change; each one replaces the stored value, and an object such as property is replaced whole. Works only on a draft, and ground and entryPoint cannot change (create a new case instead). Do not use this on a submitted case (use evictions_send_case_message to tell the team what changed). The result is the case, with state and nextAction (who it is waiting on and for what). Next: evictions_validate_case. Needs the person’s account: sign-in or an API key.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "id": "<id>"
    },
    "name": "evictions_update_case"
  }
}

Input Schema

NameRequiredDescriptionDefault
idYesThe case id (case_...), as returned by evictions_create_case or evictions_list_cases.
leaseNoThe lease, when there is one.
groundNoWhy the case is brought: nonpayment of rent, a lease violation, or holdover (the tenant stayed after the lease ended). Cannot be changed later.
ledgerNoRent charges and payments, for a nonpayment case.
partiesNoThe plaintiff (the owner or manager) and each defendant (tenant).
freeTextNoAnything else the attorney should know.
propertyNoThe rental property and its owner of record.
violationNoFor a lease violation case.
entryPointNoWhere the case starts: `notice` (a notice to the tenant comes first), or `filing` when a notice was already served (then give `priorNotice`). Cannot be changed later.
priorNoticeNoThe notice already served, for a case that starts at filing.
attestationsNoThe person’s own statements about the case. Ask the person for each one; never fill them in yourself. On an update, send all of them again: this object replaces the one stored.
rentOwedCentsNoThe unpaid rent alone, without late fees or other charges; 0 when no rent is owed. A court filing states it as the rent due, and rent claimed is never more, in US cents (150000 is $1,500.00).
amountOwedCentsNoThe total the tenant owes now, in US cents (150000 is $1,500.00).
plaintiffContactNoHow the court reaches the plaintiff (owner or manager): a Texas petition states the address and telephone.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / priorNotice / properties / method / description
      Previous value: -"How it was served: handed to the tenant, left with another adult, posted on the door, or sent by certified or first-class mail."New value: +"How it was served: handed to the tenant, left with another adult, posted on the door, sent by certified or first-class mail, or sent by text message or email. Say how it really reached the tenant."
    • changedInput schema / properties / priorNotice / properties / method / enum
      Previous value: -[
      -  "personal",
      -  "substitute",
      -  "posting",
      -  "certified_mail",
      -  "first_class_mail"
      -]New value: +[
      +  "personal",
      +  "substitute",
      +  "posting",
      +  "certified_mail",
      +  "first_class_mail",
      +  "text_message",
      +  "email"
      +]
  2. Changed13 schema fields changed
    • changedInput schema / properties / attestations / description
      Previous value: -"The person’s own statements about the case. Ask the person for each one; never fill them in yourself."New value: +"The person’s own statements about the case. Ask the person for each one; never fill them in yourself. On an update, send all of them again: this object replaces the one stored."
    • addedInput schema / properties / attestations / properties / lateBeforeNoticeMonth
      Added value: +{
      +  "description": "For nonpayment: whether the tenant was late or behind on rent before the month the notice was given. A Texas petition states it.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / lease / properties / monthToMonth
      Added value: +{
      +  "description": "For a holdover in Texas: whether the tenancy is month to month.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / lease / properties / noticeMethods
      Added value: +{
      +  "description": "In Georgia: the additional ways the rental agreement says a notice must be delivered, exactly as the lease states them, or the word `none`. The notice is posted on the door and states these methods too.",
      +  "maxLength": 500,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / lease / properties / noticePeriodDays
      Added value: +{
      +  "description": "In Texas: the notice period, in days, the written lease sets for this notice; 3 when the lease sets none.",
      +  "maximum": 365,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / lease / properties / terminationNoticeDate
      Added value: +{
      +  "description": "For a month-to-month holdover in Texas: the day written notice ending the tenancy was given, as YYYY-MM-DD.",
      +  "type": "string"
      +}
    • addedInput schema / properties / ledger / items / properties / kind
      Added value: +{
      +  "description": "For a charge only: what it is for. `other_fee` for any other charge; `eviction_fee`, `attorney_fee` or `court_cost` for a cost of the eviction itself, which no notice demands.",
      +  "enum": [
      +    "rent",
      +    "late_fee",
      +    "utilities",
      +    "other_fee",
      +    "eviction_fee",
      +    "attorney_fee",
      +    "court_cost"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / parties / items / properties / phone
      Added value: +{
      +  "description": "The party’s telephone number, if known. A Texas petition states the tenant’s.",
      +  "maxLength": 40,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / plaintiffContact
      Added value: +{
      +  "description": "How the court reaches the plaintiff (owner or manager): a Texas petition states the address and telephone.",
      +  "properties": {
      +    "address": {
      +      "description": "The plaintiff’s mailing address, on one line.",
      +      "maxLength": 500,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "email": {
      +      "description": "The plaintiff’s email address, if they want it on the filing.",
      +      "format": "email",
      +      "maxLength": 254,
      +      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      +      "type": "string"
      +    },
      +    "phone": {
      +      "description": "The plaintiff’s telephone number.",
      +      "maxLength": 40,
      +      "minLength": 1,
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "address",
      +    "phone"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / priorNotice / properties / sealedEnvelope
      Added value: +{
      +  "description": "In Georgia: whether the notice was posted in a sealed envelope on the door of the premises, as the person states it. The filing says so; a posted notice answered false there does not pass the prior-notice check.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / priorNotice / properties / type
      Added value: +{
      +  "description": "Which notice it was, as written on it: a notice to vacate, a notice to pay rent or vacate, pay or quit, or cure or quit.",
      +  "enum": [
      +    "notice_to_vacate",
      +    "notice_to_pay_rent_or_vacate",
      +    "pay_or_quit",
      +    "cure_or_quit"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / property / properties / county / description
      Previous value: -"County, when known."New value: +"County, when known, as the US Census Bureau names it (\"Henry County\" or \"Henry\"); one the state does not have is refused."
    • addedInput schema / properties / rentOwedCents
      Added value: +{
      +  "description": "The unpaid rent alone, without late fees or other charges; 0 when no rent is owed. A court filing states it as the rent due, and rent claimed is never more, in US cents (150000 is $1,500.00).",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
  3. Changed13 schema fields changed
    • changedInput schema / properties / attestations / description
      Previous value: -"The person’s own statements about the case. Ask the person for each one; never fill them in yourself. On an update, send all of them again: this object replaces the one stored."New value: +"The person’s own statements about the case. Ask the person for each one; never fill them in yourself."
    • removedInput schema / properties / attestations / properties / lateBeforeNoticeMonth
      Removed value: -{
      -  "description": "For nonpayment: whether the tenant was late or behind on rent before the month the notice was given. A Texas petition states it.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / lease / properties / monthToMonth
      Removed value: -{
      -  "description": "For a holdover in Texas: whether the tenancy is month to month.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / lease / properties / noticeMethods
      Removed value: -{
      -  "description": "In Georgia: the additional ways the rental agreement says a notice must be delivered, exactly as the lease states them, or the word `none`. The notice is posted on the door and states these methods too.",
      -  "maxLength": 500,
      -  "minLength": 1,
      -  "type": "string"
      -}
    • removedInput schema / properties / lease / properties / noticePeriodDays
      Removed value: -{
      -  "description": "In Texas: the notice period, in days, the written lease sets for this notice; 3 when the lease sets none.",
      -  "maximum": 365,
      -  "minimum": 1,
      -  "type": "integer"
      -}
    • removedInput schema / properties / lease / properties / terminationNoticeDate
      Removed value: -{
      -  "description": "For a month-to-month holdover in Texas: the day written notice ending the tenancy was given, as YYYY-MM-DD.",
      -  "type": "string"
      -}
    • removedInput schema / properties / ledger / items / properties / kind
      Removed value: -{
      -  "description": "For a charge only: what it is for. `other_fee` for any other charge; `eviction_fee`, `attorney_fee` or `court_cost` for a cost of the eviction itself, which no notice demands.",
      -  "enum": [
      -    "rent",
      -    "late_fee",
      -    "utilities",
      -    "other_fee",
      -    "eviction_fee",
      -    "attorney_fee",
      -    "court_cost"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / parties / items / properties / phone
      Removed value: -{
      -  "description": "The party’s telephone number, if known. A Texas petition states the tenant’s.",
      -  "maxLength": 40,
      -  "minLength": 1,
      -  "type": "string"
      -}
    • removedInput schema / properties / plaintiffContact
      Removed value: -{
      -  "description": "How the court reaches the plaintiff (owner or manager): a Texas petition states the address and telephone.",
      -  "properties": {
      -    "address": {
      -      "description": "The plaintiff’s mailing address, on one line.",
      -      "maxLength": 500,
      -      "minLength": 1,
      -      "type": "string"
      -    },
      -    "email": {
      -      "description": "The plaintiff’s email address, if they want it on the filing.",
      -      "format": "email",
      -      "maxLength": 254,
      -      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      -      "type": "string"
      -    },
      -    "phone": {
      -      "description": "The plaintiff’s telephone number.",
      -      "maxLength": 40,
      -      "minLength": 1,
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "address",
      -    "phone"
      -  ],
      -  "type": "object"
      -}
    • removedInput schema / properties / priorNotice / properties / sealedEnvelope
      Removed value: -{
      -  "description": "In Georgia: whether the notice was posted in a sealed envelope on the door of the premises, as the person states it. The filing says so; a posted notice answered false there does not pass the prior-notice check.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / priorNotice / properties / type
      Removed value: -{
      -  "description": "Which notice it was, as written on it: a notice to vacate, a notice to pay rent or vacate, pay or quit, or cure or quit.",
      -  "enum": [
      -    "notice_to_vacate",
      -    "notice_to_pay_rent_or_vacate",
      -    "pay_or_quit",
      -    "cure_or_quit"
      -  ],
      -  "type": "string"
      -}
    • changedInput schema / properties / property / properties / county / description
      Previous value: -"County, when known, as the US Census Bureau names it (\"Henry County\" or \"Henry\"); one the state does not have is refused."New value: +"County, when known."
    • removedInput schema / properties / rentOwedCents
      Removed value: -{
      -  "description": "The unpaid rent alone, without late fees or other charges; 0 when no rent is owed. A court filing states it as the rent due, and rent claimed is never more, in US cents (150000 is $1,500.00).",
      -  "maximum": 9007199254740991,
      -  "minimum": 0,
      -  "type": "integer"
      -}
  4. Changed2 schema fields changed
    • addedInput schema / properties / ledger / items / properties / kind
      Added value: +{
      +  "description": "For a charge only: what it is for. `other_fee` for any other charge; `eviction_fee`, `attorney_fee` or `court_cost` for a cost of the eviction itself, which no notice demands.",
      +  "enum": [
      +    "rent",
      +    "late_fee",
      +    "utilities",
      +    "other_fee",
      +    "eviction_fee",
      +    "attorney_fee",
      +    "court_cost"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / property / properties / county / description
      Previous value: -"County, when known."New value: +"County, when known, as the US Census Bureau names it (\"Henry County\" or \"Henry\"); one the state does not have is refused."
  5. Changed2 schema fields changed
    • addedInput schema / properties / lease / properties / noticeMethods
      Added value: +{
      +  "description": "In Georgia: the additional ways the rental agreement says a notice must be delivered, exactly as the lease states them, or the word `none`. The notice is posted on the door and states these methods too.",
      +  "maxLength": 500,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / priorNotice / properties / sealedEnvelope
      Added value: +{
      +  "description": "In Georgia: whether the notice was posted in a sealed envelope on the door of the premises, as the person states it. The filing says so; a posted notice answered false there does not pass the prior-notice check.",
      +  "type": "boolean"
      +}
  6. Changed3 schema fields changed
    • addedInput schema / properties / lease / properties / monthToMonth
      Added value: +{
      +  "description": "For a holdover in Texas: whether the tenancy is month to month.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / lease / properties / noticePeriodDays
      Added value: +{
      +  "description": "In Texas: the notice period, in days, the written lease sets for this notice; 3 when the lease sets none.",
      +  "maximum": 365,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / lease / properties / terminationNoticeDate
      Added value: +{
      +  "description": "For a month-to-month holdover in Texas: the day written notice ending the tenancy was given, as YYYY-MM-DD.",
      +  "type": "string"
      +}
  7. Changed6 schema fields changed
    • changedInput schema / properties / attestations / description
      Previous value: -"The person’s own statements about the case. Ask the person for each one; never fill them in yourself."New value: +"The person’s own statements about the case. Ask the person for each one; never fill them in yourself. On an update, send all of them again: this object replaces the one stored."
    • addedInput schema / properties / attestations / properties / lateBeforeNoticeMonth
      Added value: +{
      +  "description": "For nonpayment: whether the tenant was late or behind on rent before the month the notice was given. A Texas petition states it.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / parties / items / properties / phone
      Added value: +{
      +  "description": "The party’s telephone number, if known. A Texas petition states the tenant’s.",
      +  "maxLength": 40,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / plaintiffContact
      Added value: +{
      +  "description": "How the court reaches the plaintiff (owner or manager): a Texas petition states the address and telephone.",
      +  "properties": {
      +    "address": {
      +      "description": "The plaintiff’s mailing address, on one line.",
      +      "maxLength": 500,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "email": {
      +      "description": "The plaintiff’s email address, if they want it on the filing.",
      +      "format": "email",
      +      "maxLength": 254,
      +      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      +      "type": "string"
      +    },
      +    "phone": {
      +      "description": "The plaintiff’s telephone number.",
      +      "maxLength": 40,
      +      "minLength": 1,
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "address",
      +    "phone"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / priorNotice / properties / type
      Added value: +{
      +  "description": "Which notice it was, as written on it: a notice to vacate, a notice to pay rent or vacate, pay or quit, or cure or quit.",
      +  "enum": [
      +    "notice_to_vacate",
      +    "notice_to_pay_rent_or_vacate",
      +    "pay_or_quit",
      +    "cure_or_quit"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / rentOwedCents
      Added value: +{
      +  "description": "The unpaid rent alone, without late fees or other charges; 0 when no rent is owed. A court filing states it as the rent due, and rent claimed is never more, in US cents (150000 is $1,500.00).",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
  8. First observed

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations (destructiveHint=true, idempotentHint=true), it discloses the replacement semantics that matter most: supplied fields overwrite stored values, objects are replaced whole, and only drafts are modifiable. It also states the return shape (case with state and nextAction) and the auth requirement. It stops short of covering partial-failure behavior, but the destructive-replace warning is exactly the context annotations cannot convey.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the trigger, then input, constraints, exclusions, result, next step, and auth in short labeled clauses. Dense but every sentence carries information; only the auth sentence is slightly tacked on at the end.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 14-parameter nested mutation tool with no output schema, it covers the trigger, immutability constraints, draft-only scope, replacement semantics, return payload, follow-up step, and credential requirement. Nothing an agent needs to call it safely is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so parameter meaning is already largely carried by the schema, which also already flags ground and entryPoint as unchangeable. The description adds the merge-patch contract (only send fields to change; whole objects replace rather than merge) which is genuinely useful, but it does not elaborate on any individual field.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Names a specific verb and resource (correcting/completing a draft case's facts) and immediately distinguishes it from evictions_validate_case, evictions_create_case, and evictions_send_case_message. An agent can tell what this does and what it does not do without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives an explicit trigger (draft facts need correcting, e.g. after evictions_validate_case reports gaps), an explicit exclusion (submitted cases), and names the alternative for that case (evictions_send_case_message) and for immutable fields (create a new case). Also names the natural follow-up, evictions_validate_case.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.