Evictions API

Official18 tools

by evictionsapi

Start and track a US eviction case in any state or DC; a licensed attorney reviews each real case.

io.github.evictionsapi/evictions-api — Evictions API (MCP Server)

This MCP server provides access to US/DC eviction cases. The description specifies that a licensed attorney reviews each real case before anything is served or filed, indicating a review step tied to the underlying real-case information.

🛠️ Key Features

US/DC eviction cases
Licensed attorney review of each real case before anything is served or filed

🚀 Use Cases

Retrieving information related to eviction cases in the US/DC domain
Workflows that require reviewed case data prior to serving or filing

⚡ Developer Benefits

Clear scope limited to US/DC eviction cases
Documented attorney review process as part of the case handling lifecycle

⚠️ Limitations

Only eviction cases for the US/DC scope are covered

Topics

ai-agentsevictionlandlordlegaltechmcpmcp-serveropenapiproperty-managementproptechrest-api

Captured live from the server via tools/list.

evictions_get_service_overview

Use this when the person asks what Evictions API is, what is available today, how a real case is handled or who operates it. Takes no input. Returns the service’s description, its current status and who operates it, in the site’s own words, with links to the home and how-it-works pages. Do not use this for fees (use evictions_get_pricing) or for one state’s rules (use evictions_get_state_eviction_facts). No key needed.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_get_pricing

Use this when the person asks what a case costs or about refunds. Takes no input. Returns the platform fee, the costs that are separate from it and the refund rule, word for word as the pricing page says them, with its link. Do not use this for the charges already on a case (use evictions_list_case_charges). No key needed.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_list_states

Use this when you need every place the service covers, or the exact code or slug of a state. Takes no input. Returns the 50 states and DC, each with its two-letter code, name, slug and page on the site. Do not use this for one state’s eviction rules (use evictions_get_state_eviction_facts). No key needed.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_get_state_eviction_facts

Use this when the person asks how eviction works in one state, such as the notice for nonpayment of rent or the court. Input: `state`, as a two-letter code, a name or a slug. Returns the page’s opening answer and only the facts published as verified and sourced for that state, each with its citation, source link, the date it was checked and a short quote of the cited text where there is one (a fact checked more than 90 days ago is left out), plus the state’s page and a notice that this is general information, not legal advice; a state with none says so. Do not use this for whether a case can be opened at an address (use evictions_resolve_jurisdiction) or for advice on a particular case. No key needed.

Parameters1

state

string

required

A two-letter code (TX), a state name (Texas) or its slug (texas). DC is the District of Columbia.

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "A two-letter code (TX), a state name (Texas) or its slug (texas). DC is the District of Columbia."
    }
  },
  "required": [
    "state"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_get_started

Use this when the person has no account or key yet, or asks how to connect an agent. Takes no input. Returns the sign-up link, what test and live keys are, how this MCP server is reached and signed in to, and the links to the docs and the OpenAPI document. Do not use this to check a key the person already has: any tool that works with cases says so when its key is missing or refused. No key needed.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_resolve_jurisdiction

Use this when you need to know, before creating a case, whether a case can be opened for a property’s location and which facts each ground of eviction needs there. Input: `state`, and `county` and `city` when known. Returns whether the jurisdiction is served and, for each ground, the facts a case needs, and with a test key also the notice rules of the fictional state ZZ. Do not use this for a state’s published facts with their sources (use evictions_get_state_eviction_facts, which needs no key). Next: evictions_create_case. Needs the person’s account: sign-in or an API key.

Parameters3

state	string	required	Two-letter state code, for example TX; DC for the District of Columbia. Test keys use the fictional state ZZ.
county	string	optional	County of the property, when known.
city	string	optional	City of the property, when known.

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Two-letter state code, for example TX; DC for the District of Columbia. Test keys use the fictional state ZZ."
    },
    "county": {
      "description": "County of the property, when known.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "city": {
      "description": "City of the property, when known.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    }
  },
  "required": [
    "state"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_create_case

Use this when the person wants to start an eviction case and has given you its facts: the ground, where the case starts, the property, the parties and their own attestations. Creates a draft case in the person’s account. Nothing is submitted. Documents are uploaded through the REST API or the site, not this server. Pass an `idempotencyKey` and reuse it if you repeat the call, so a retry never makes a second case. Do not use this to change a case that already exists (use evictions_update_case). 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.

Parameters12

ground	string	required	Why the case is brought: nonpayment of rent, a lease violation, or holdover (the tenant stayed after the lease ended). Cannot be changed later.
entryPoint	string	required	Where 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.
property	object	required	The rental property and its owner of record.
parties	array	required	The plaintiff (the owner or manager) and each defendant (tenant).
lease	object	optional	The lease, when there is one.
ledger	array	optional	Rent charges and payments, for a nonpayment case.
amountOwedCents	integer	optional	The total the tenant owes now, in US cents (150000 is $1,500.00).
violation	object	optional	For a lease violation case.
attestations	object	required	The person’s own statements about the case. Ask the person for each one; never fill them in yourself.
priorNotice	object	optional	The notice already served, for a case that starts at filing.
freeText	string	optional	Anything else the attorney should know.
idempotencyKey	string	optional	Sent as the Idempotency-Key header (printable ASCII, no spaces): a repeat of the same request with the same key returns the first answer instead of a second case. Always pass one, and reuse it if you repeat the call.

Raw schema

{
  "type": "object",
  "properties": {
    "ground": {
      "type": "string",
      "enum": [
        "nonpayment",
        "lease_violation",
        "holdover"
      ],
      "description": "Why the case is brought: nonpayment of rent, a lease violation, or holdover (the tenant stayed after the lease ended). Cannot be changed later."
    },
    "entryPoint": {
      "type": "string",
      "enum": [
        "notice",
        "filing"
      ],
      "description": "Where 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."
    },
    "property": {
      "type": "object",
      "properties": {
        "line1": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "description": "Street address of the rental property."
        },
        "unit": {
          "description": "Unit or apartment number, if any.",
          "type": "string",
          "minLength": 1,
          "maxLength": 50
        },
        "city": {
          "type": "string",
          "minLength": 1,
          "maxLength": 100,
          "description": "City."
        },
        "county": {
          "description": "County, when known.",
          "type": "string",
          "minLength": 1,
          "maxLength": 100
        },
        "state": {
          "type": "string",
          "pattern": "^[A-Za-z]{2}$",
          "description": "Two-letter state code, for example TX; DC for the District of Columbia. Test keys use the fictional state ZZ."
        },
        "zip": {
          "type": "string",
          "pattern": "^\\d{5}(-\\d{4})?$",
          "description": "ZIP code: 5 digits, or ZIP+4 (12345-6789)."
        },
        "ownerOfRecord": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "description": "The owner of the property as on the deed: a person or a company."
        }
      },
      "required": [
        "line1",
        "city",
        "state",
        "zip",
        "ownerOfRecord"
      ],
      "description": "The rental property and its owner of record."
    },
    "parties": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string",
            "enum": [
              "plaintiff",
              "defendant"
            ],
            "description": "`plaintiff` for the owner or manager bringing the case, `defendant` for each tenant."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Full legal name of the person or company."
          },
          "isEntity": {
            "description": "True when the party is a company rather than a person.",
            "type": "boolean"
          }
        },
        "required": [
          "role",
          "name"
        ]
      },
      "description": "The plaintiff (the owner or manager) and each defendant (tenant)."
    },
    "lease": {
      "description": "The lease, when there is one.",
      "type": "object",
      "properties": {
        "startDate": {
          "type": "string",
          "description": "The day the lease began, as YYYY-MM-DD."
        },
        "endDate": {
          "type": "string",
          "description": "The day the lease ends or ended, as YYYY-MM-DD."
        },
        "monthlyRentCents": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "The monthly rent, in US cents (150000 is $1,500.00)."
        }
      }
    },
    "ledger": {
      "description": "Rent charges and payments, for a nonpayment case.",
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "The day of the charge or payment, as YYYY-MM-DD."
          },
          "type": {
            "type": "string",
            "enum": [
              "charge",
              "payment"
            ],
            "description": "`charge` for rent or a fee owed, `payment` for money received."
          },
          "amountCents": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "The amount, in US cents (150000 is $1,500.00)."
          },
          "memo": {
            "description": "What it was for, such as \"October rent\".",
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          }
        },
        "required": [
          "date",
          "type",
          "amountCents"
        ]
      }
    },
    "amountOwedCents": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "The total the tenant owes now, in US cents (150000 is $1,500.00)."
    },
    "violation": {
      "description": "For a lease violation case.",
      "type": "object",
      "properties": {
        "description": {
          "type": "string",
          "minLength": 1,
          "maxLength": 5000,
          "description": "What the tenant did that breaks the lease, in the person’s words."
        },
        "date": {
          "type": "string",
          "description": "The day it happened, as YYYY-MM-DD."
        }
      },
      "required": [
        "description",
        "date"
      ]
    },
    "attestations": {
      "type": "object",
      "properties": {
        "authority": {
          "description": "The person owns the property or is authorized to act for the owner in this eviction.",
          "type": "boolean"
        },
        "notRetaliatory": {
          "description": "The eviction is not in response to the tenant making a complaint, reporting a problem to an authority, or using a legal right.",
          "type": "boolean"
        },
        "notDiscriminatory": {
          "description": "The eviction is not based on who the tenant is, such as their race, religion, sex, national origin, disability or family status.",
          "type": "boolean"
        },
        "servicemember": {
          "description": "Whether the tenant is on active military duty; `unknown` is an accepted answer.",
          "type": "string",
          "enum": [
            "no",
            "yes",
            "unknown"
          ]
        },
        "caresCovered": {
          "description": "Whether the property is covered by the federal CARES Act.",
          "type": "boolean"
        },
        "subsidized": {
          "description": "Whether the tenant lives in subsidized housing or receives rental assistance, such as a housing voucher.",
          "type": "boolean"
        }
      },
      "description": "The person’s own statements about the case. Ask the person for each one; never fill them in yourself."
    },
    "priorNotice": {
      "description": "The notice already served, for a case that starts at filing.",
      "type": "object",
      "properties": {
        "servedDate": {
          "type": "string",
          "description": "The day the notice was served, as YYYY-MM-DD."
        },
        "method": {
          "type": "string",
          "enum": [
            "personal",
            "substitute",
            "posting",
            "certified_mail",
            "first_class_mail"
          ],
          "description": "How it was served: handed to the tenant, left with another adult, posted on the door, or sent by certified or first-class mail."
        },
        "periodDays": {
          "type": "integer",
          "minimum": 1,
          "maximum": 365,
          "description": "How many days the notice gave the tenant."
        }
      },
      "required": [
        "servedDate",
        "method",
        "periodDays"
      ]
    },
    "freeText": {
      "description": "Anything else the attorney should know.",
      "type": "string",
      "maxLength": 5000
    },
    "idempotencyKey": {
      "description": "Sent as the Idempotency-Key header (printable ASCII, no spaces): a repeat of the same request with the same key returns the first answer instead of a second case. Always pass one, and reuse it if you repeat the call.",
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[\\x21-\\x7E]+$"
    }
  },
  "required": [
    "ground",
    "entryPoint",
    "property",
    "parties",
    "attestations"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_update_case

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.

Parameters12

id	string	required	The case id (case_...), as returned by evictions_create_case or evictions_list_cases.
ground	string	optional	Why the case is brought: nonpayment of rent, a lease violation, or holdover (the tenant stayed after the lease ended). Cannot be changed later.
entryPoint	string	optional	Where 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.
property	object	optional	The rental property and its owner of record.
parties	array	optional	The plaintiff (the owner or manager) and each defendant (tenant).
lease	object	optional	The lease, when there is one.
ledger	array	optional	Rent charges and payments, for a nonpayment case.
amountOwedCents	integer	optional	The total the tenant owes now, in US cents (150000 is $1,500.00).
violation	object	optional	For a lease violation case.
attestations	object	optional	The person’s own statements about the case. Ask the person for each one; never fill them in yourself.
priorNotice	object	optional	The notice already served, for a case that starts at filing.
freeText	string	optional	Anything else the attorney should know.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,100}$",
      "description": "The case id (case_...), as returned by evictions_create_case or evictions_list_cases."
    },
    "ground": {
      "type": "string",
      "enum": [
        "nonpayment",
        "lease_violation",
        "holdover"
      ],
      "description": "Why the case is brought: nonpayment of rent, a lease violation, or holdover (the tenant stayed after the lease ended). Cannot be changed later."
    },
    "entryPoint": {
      "type": "string",
      "enum": [
        "notice",
        "filing"
      ],
      "description": "Where 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."
    },
    "property": {
      "type": "object",
      "properties": {
        "line1": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "description": "Street address of the rental property."
        },
        "unit": {
          "description": "Unit or apartment number, if any.",
          "type": "string",
          "minLength": 1,
          "maxLength": 50
        },
        "city": {
          "type": "string",
          "minLength": 1,
          "maxLength": 100,
          "description": "City."
        },
        "county": {
          "description": "County, when known.",
          "type": "string",
          "minLength": 1,
          "maxLength": 100
        },
        "state": {
          "type": "string",
          "pattern": "^[A-Za-z]{2}$",
          "description": "Two-letter state code, for example TX; DC for the District of Columbia. Test keys use the fictional state ZZ."
        },
        "zip": {
          "type": "string",
          "pattern": "^\\d{5}(-\\d{4})?$",
          "description": "ZIP code: 5 digits, or ZIP+4 (12345-6789)."
        },
        "ownerOfRecord": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "description": "The owner of the property as on the deed: a person or a company."
        }
      },
      "required": [
        "line1",
        "city",
        "state",
        "zip",
        "ownerOfRecord"
      ],
      "description": "The rental property and its owner of record."
    },
    "parties": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string",
            "enum": [
              "plaintiff",
              "defendant"
            ],
            "description": "`plaintiff` for the owner or manager bringing the case, `defendant` for each tenant."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Full legal name of the person or company."
          },
          "isEntity": {
            "description": "True when the party is a company rather than a person.",
            "type": "boolean"
          }
        },
        "required": [
          "role",
          "name"
        ]
      },
      "description": "The plaintiff (the owner or manager) and each defendant (tenant)."
    },
    "lease": {
      "description": "The lease, when there is one.",
      "type": "object",
      "properties": {
        "startDate": {
          "type": "string",
          "description": "The day the lease began, as YYYY-MM-DD."
        },
        "endDate": {
          "type": "string",
          "description": "The day the lease ends or ended, as YYYY-MM-DD."
        },
        "monthlyRentCents": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "The monthly rent, in US cents (150000 is $1,500.00)."
        }
      }
    },
    "ledger": {
      "description": "Rent charges and payments, for a nonpayment case.",
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "The day of the charge or payment, as YYYY-MM-DD."
          },
          "type": {
            "type": "string",
            "enum": [
              "charge",
              "payment"
            ],
            "description": "`charge` for rent or a fee owed, `payment` for money received."
          },
          "amountCents": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "The amount, in US cents (150000 is $1,500.00)."
          },
          "memo": {
            "description": "What it was for, such as \"October rent\".",
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          }
        },
        "required": [
          "date",
          "type",
          "amountCents"
        ]
      }
    },
    "amountOwedCents": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "The total the tenant owes now, in US cents (150000 is $1,500.00)."
    },
    "violation": {
      "description": "For a lease violation case.",
      "type": "object",
      "properties": {
        "description": {
          "type": "string",
          "minLength": 1,
          "maxLength": 5000,
          "description": "What the tenant did that breaks the lease, in the person’s words."
        },
        "date": {
          "type": "string",
          "description": "The day it happened, as YYYY-MM-DD."
        }
      },
      "required": [
        "description",
        "date"
      ]
    },
    "attestations": {
      "type": "object",
      "properties": {
        "authority": {
          "description": "The person owns the property or is authorized to act for the owner in this eviction.",
          "type": "boolean"
        },
        "notRetaliatory": {
          "description": "The eviction is not in response to the tenant making a complaint, reporting a problem to an authority, or using a legal right.",
          "type": "boolean"
        },
        "notDiscriminatory": {
          "description": "The eviction is not based on who the tenant is, such as their race, religion, sex, national origin, disability or family status.",
          "type": "boolean"
        },
        "servicemember": {
          "description": "Whether the tenant is on active military duty; `unknown` is an accepted answer.",
          "type": "string",
          "enum": [
            "no",
            "yes",
            "unknown"
          ]
        },
        "caresCovered": {
          "description": "Whether the property is covered by the federal CARES Act.",
          "type": "boolean"
        },
        "subsidized": {
          "description": "Whether the tenant lives in subsidized housing or receives rental assistance, such as a housing voucher.",
          "type": "boolean"
        }
      },
      "description": "The person’s own statements about the case. Ask the person for each one; never fill them in yourself."
    },
    "priorNotice": {
      "description": "The notice already served, for a case that starts at filing.",
      "type": "object",
      "properties": {
        "servedDate": {
          "type": "string",
          "description": "The day the notice was served, as YYYY-MM-DD."
        },
        "method": {
          "type": "string",
          "enum": [
            "personal",
            "substitute",
            "posting",
            "certified_mail",
            "first_class_mail"
          ],
          "description": "How it was served: handed to the tenant, left with another adult, posted on the door, or sent by certified or first-class mail."
        },
        "periodDays": {
          "type": "integer",
          "minimum": 1,
          "maximum": 365,
          "description": "How many days the notice gave the tenant."
        }
      },
      "required": [
        "servedDate",
        "method",
        "periodDays"
      ]
    },
    "freeText": {
      "description": "Anything else the attorney should know.",
      "type": "string",
      "maxLength": 5000
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_get_case

Use this when you need one case in full: where it stands and what it is waiting on. Input: the case `id`. Returns its facts, deadlines, documents and, for a live case, the attorney once recorded. Do not use this to find a case whose id you do not have (use evictions_list_cases) or for its history (use evictions_get_case_events). The result is the case, with `state` and `nextAction` (who it is waiting on and for what). Needs the person’s account: sign-in or an API key.

Parameters1

id

string

required

The case id (case_...), as returned by evictions_create_case or evictions_list_cases.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,100}$",
      "description": "The case id (case_...), as returned by evictions_create_case or evictions_list_cases."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_list_cases

Use this when you need the person’s cases, or the id of a case you do not have. Input: optional `limit` and `cursor`. Returns the cases of the key’s organization and mode (test or live), newest first, a page at a time, each with its `state` and `nextAction`, and `nextCursor` for the next page (null on the last). Do not use this when you already have the case id (use evictions_get_case). Needs the person’s account: sign-in or an API key.

Parameters2

cursor	string	optional	`nextCursor` from the page before, for the next page. Leave it out for the first page.
limit	integer	optional	How many to return, at most 100. The default is 20.

Raw schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "`nextCursor` from the page before, for the next page. Leave it out for the first page.",
      "type": "string",
      "maxLength": 512
    },
    "limit": {
      "description": "How many to return, at most 100. The default is 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_validate_case

Use this when a draft looks complete, before asking the person to confirm its submission. Input: the case `id`. Runs the submission checks on a draft and returns each check’s result, with the reason when it does not pass, and whether all passed. Changes nothing. Do not use this to submit (use evictions_submit_case). Next: evictions_update_case to fill a gap, or the person’s yes and then evictions_submit_case. Needs the person’s account: sign-in or an API key.

Parameters1

id

string

required

The case id (case_...), as returned by evictions_create_case or evictions_list_cases.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,100}$",
      "description": "The case id (case_...), as returned by evictions_create_case or evictions_list_cases."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_submit_case

Use this when the person has said yes to submitting a draft that passes every check. Input: the case `id` and `confirmedByPerson`. A live case moves to `submitted`, its platform fee becomes a due charge, and a licensed attorney in the property’s state is engaged for it; nothing is served or filed until that attorney has reviewed it. With a test key the case is fictional and goes through a simulated review instead. With a live key this acts on a real case. Confirm with the person first, then pass `confirmedByPerson: true`. The case’s attestations must be the person’s own statements; never fill them in yourself. Do not use this to check a draft (use evictions_validate_case). Returns the case and its check results. Next: evictions_list_case_charges for the fee. Needs the person’s account: sign-in or an API key.

Parameters2

id	string	required	The case id (case_...), as returned by evictions_create_case or evictions_list_cases.
confirmedByPerson	boolean	required	Set to true only after the person has said yes to this exact action on this case, in this conversation.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,100}$",
      "description": "The case id (case_...), as returned by evictions_create_case or evictions_list_cases."
    },
    "confirmedByPerson": {
      "type": "boolean",
      "const": true,
      "description": "Set to true only after the person has said yes to this exact action on this case, in this conversation."
    }
  },
  "required": [
    "id",
    "confirmedByPerson"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_get_case_events

Use this when the person asks what has happened on a case so far. Input: the case `id`. Returns the events the person may see, oldest first, each with what happened, the state before and after, and when. Do not use this for where the case stands now (use evictions_get_case) or for messages (use evictions_list_case_messages). Needs the person’s account: sign-in or an API key.

Parameters1

id

string

required

The case id (case_...), as returned by evictions_create_case or evictions_list_cases.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,100}$",
      "description": "The case id (case_...), as returned by evictions_create_case or evictions_list_cases."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_list_case_charges

Use this when the person asks what they owe on a case or whether a charge is paid. Input: the case `id`. Returns the charges on a case, oldest first, each with its id, kind, amount in cents and status (due, paid, void or refunded), and whether online payment is available. Do not use this for the published prices (use evictions_get_pricing). Next: evictions_get_payment_link for a due charge. Needs the person’s account: sign-in or an API key.

Parameters1

id

string

required

The case id (case_...), as returned by evictions_create_case or evictions_list_cases.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,100}$",
      "description": "The case id (case_...), as returned by evictions_create_case or evictions_list_cases."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_get_payment_link

Use this when the person wants to pay a due charge on a case. Input: the case `id` and the `chargeId` from evictions_list_case_charges. Opens a hosted checkout for one due charge and returns its URL; asked again while that checkout is open, it returns the same URL. Give the URL to the person: paying is theirs to do, and no tool takes card details. Refused when the charge is not due or online payment is off. Do not use this to see whether a charge is paid (use evictions_list_case_charges). Needs the person’s account: sign-in or an API key.

Parameters2

id	string	required	The case id (case_...), as returned by evictions_create_case or evictions_list_cases.
chargeId	string	required	The id of a due charge on that case, from evictions_list_case_charges.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,100}$",
      "description": "The case id (case_...), as returned by evictions_create_case or evictions_list_cases."
    },
    "chargeId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,100}$",
      "description": "The id of a due charge on that case, from evictions_list_case_charges."
    }
  },
  "required": [
    "id",
    "chargeId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_list_case_messages

Use this when the person asks whether the Evictions API team has written about a case, or before writing to it. Input: the case `id`. Returns the messages on a case, the person’s own and the team’s, oldest first, each with its author, text and time. Do not use this for the case’s events (use evictions_get_case_events). Next: evictions_send_case_message to reply. Needs the person’s account: sign-in or an API key.

Parameters1

id

string

required

The case id (case_...), as returned by evictions_create_case or evictions_list_cases.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,100}$",
      "description": "The case id (case_...), as returned by evictions_create_case or evictions_list_cases."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_send_case_message

Use this when the person asks you to write to the Evictions API team about one of their live cases. Input: the case `id` and `body`. Sends the team a message about a live case, in the person’s name, and the team is told by email. Send only what the person asked to say. Each call sends one more message; a test case is refused, and an organization can send at most 20 every 10 minutes. Returns the message as stored. Do not use this to change a draft (use evictions_update_case). Needs the person’s account: sign-in or an API key.

Parameters2

id	string	required	The case id (case_...), as returned by evictions_create_case or evictions_list_cases.
body	string	required	The message, in the person’s words: only what they asked to say.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,100}$",
      "description": "The case id (case_...), as returned by evictions_create_case or evictions_list_cases."
    },
    "body": {
      "type": "string",
      "minLength": 1,
      "maxLength": 5000,
      "description": "The message, in the person’s words: only what they asked to say."
    }
  },
  "required": [
    "id",
    "body"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

evictions_withdraw_case

Use this when the person has decided to withdraw a case and stop it. Input: the case `id` and `confirmedByPerson`. A live case with an attorney already engaged goes on hold instead and is withdrawn once the attorney has confirmed that all work has stopped. With a live key this acts on a real case. Confirm with the person first, then pass `confirmedByPerson: true`. Do not use this to report that the tenant has paid or to ask a question (use evictions_send_case_message). The result is the case, with `state` and `nextAction` (who it is waiting on and for what). Needs the person’s account: sign-in or an API key.

Parameters2

id	string	required	The case id (case_...), as returned by evictions_create_case or evictions_list_cases.
confirmedByPerson	boolean	required	Set to true only after the person has said yes to this exact action on this case, in this conversation.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,100}$",
      "description": "The case id (case_...), as returned by evictions_create_case or evictions_list_cases."
    },
    "confirmedByPerson": {
      "type": "boolean",
      "const": true,
      "description": "Set to true only after the person has said yes to this exact action on this case, in this conversation."
    }
  },
  "required": [
    "id",
    "confirmedByPerson"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md4 KBView on GitHub

Evictions API — public examples

Hand your eviction paperwork to your AI agent. A licensed attorney reviews it before anything is served or filed.

Evictions API (operated by Future Cities LLC) is a REST API and MCP server for starting and tracking a residential eviction case in any US state or DC. Evictions API is not a law firm and does not give legal advice.

Site: https://evictionsapi.com
API: https://api.evictionsapi.com/v1
Docs: https://evictionsapi.com/docs
Agents / MCP: https://evictionsapi.com/docs/agents
OpenAPI (live): https://api.evictionsapi.com/v1/openapi.json
llms.txt: https://evictionsapi.com/llms.txt

This repository holds the OpenAPI document, copy-and-paste examples, and MCP client configs. The product source code is private.

Fees (real cases)

Platform fee: $29 when a case starts at the notice stage; $99 in total through filing (the $29 is credited). A case that starts at filing pays $99 once. The attorney’s legal fee and court and service costs are separate: they are quoted before any work begins and you approve them first. The legal fee is paid to the attorney. The API and test mode are free.

If no attorney is engaged within 5 business days of submission, the platform fee is refunded in full. We do not promise outcomes or how long a case takes.

Quickstart (test mode, fictional state ZZ)

Sign up and copy a free test key (eak_test_…): https://evictionsapi.com/signup?next=/app/get-started
Set environment variables:

bash

export EVICTIONS_API_URL=https://api.evictionsapi.com
export EVICTIONS_API_KEY=eak_test_...

Run one of the examples:

Language	Path	Needs key?	Tested here
curl	`examples/curl/quickstart.sh`	Yes	Untested (needs your key)
Node	`examples/node/quickstart.mjs`	Yes	Untested (needs your key)
Python	`examples/python/quickstart.py`	Yes	Untested (needs your key)
Public smoke	`examples/curl/public-smoke.sh`	No	Tested 2026-10-06 against the live API

Test mode uses the fictional state ZZ. Nothing is served or filed, and nothing reaches a real tenant, attorney, or court. In test mode a built-in sandbox reviewer and adapters move the case; call POST /v1/cases/{id}/advance until the state is closed.

Live mode uses a real property state. After you submit, we engage a licensed attorney in that state for the case. Nothing is served or filed until that attorney has reviewed it. Live keys are created only by an organization owner, signed in on the site.

MCP setup

MCP server (Streamable HTTP): https://evictionsapi.com/mcp
Discovery: https://evictionsapi.com/.well-known/mcp.json
Full guide: https://evictionsapi.com/docs/agents

Tools that describe the service, pricing, and each state need no key. Tools that work with cases need Authorization: Bearer eak_….

Claude Desktop / Claude web

Customize → Connectors → Add custom connector → URL https://evictionsapi.com/mcp. For case tools, add header Authorization = Bearer eak_test_....

Claude Code

bash

claude mcp add --transport http evictions-api https://evictionsapi.com/mcp \
  --header "Authorization: Bearer eak_test_..."

Cursor

Put this in .cursor/mcp.json (project) or ~/.cursor/mcp.json (all projects). Do not commit a real key.

json

{
  "mcpServers": {
    "evictions-api": {
      "url": "https://evictionsapi.com/mcp",
      "headers": {
        "Authorization": "Bearer eak_test_..."
      }
    }
  }
}

VS Code / other Streamable HTTP clients

See https://evictionsapi.com/docs/agents for VS Code mcp.json, ChatGPT (no-key tools only), and the tool list.

OpenAPI

openapi.json was fetched from https://api.evictionsapi.com/v1/openapi.json on 2026-10-06 (OpenAPI 3.1, no key required). Prefer the live URL so you stay current.

License

Contact

hello@evictionsapi.com
https://evictionsapi.com/contact

Install

Tools (18)

evictions_get_service_overviewevictions_get_pricingevictions_list_statesevictions_get_state_eviction_factsevictions_get_startedevictions_resolve_jurisdictionevictions_create_caseevictions_update_case

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://evictionsapi.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "evictions-api": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://evictionsapi.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.