Evictions API — public examples

MCP serverDev tools

US/DC eviction cases. A licensed attorney reviews each real case before anything is served or filed.

Use Evictions API — public examples in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Evictions API — public examples and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the evictions get service overview tool from Evictions API

Details

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Evictions API — public examplesStart free

Install Evictions API — public examples

The server’s own address, for the clients that take one directly. Or connect ahel once and every client you use reads it from one address, with the account kept on ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user evictions-api-public-examples 'https://evictionsapi.com/mcp'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://evictionsapi.com/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=evictions-api-public-examples&config=eyJ1cmwiOiJodHRwczovL2V2aWN0aW9uc2FwaS5jb20vbWNwIn0=

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://evictionsapi.com/mcp

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add evictions-api-public-examples --url 'https://evictionsapi.com/mcp'

    Run it once, then sign in with codex mcp login evictions-api-public-examples if the server asks for an account.

From the project's README

As published by evictionsapi/evictions-api in README.md.

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.

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)

  1. Sign up and copy a free test key (eak_test_…): https://evictionsapi.com/signup?next=/app/get-started
  2. Set environment variables:
export EVICTIONS_API_URL=https://api.evictionsapi.com
export EVICTIONS_API_KEY=eak_test_...
  1. Run one of the examples:
LanguagePathNeeds key?Tested here
curlexamples/curl/quickstart.shYesUntested (needs your key)
Nodeexamples/node/quickstart.mjsYesUntested (needs your key)
Pythonexamples/python/quickstart.pyYesUntested (needs your key)
Public smokeexamples/curl/public-smoke.shNoTested 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

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.

{
  "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

MIT for the examples and configs in this repository. Evictions API the product remains © Future Cities LLC.

Contact

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

Tools it offers (18)

What this server listed when ahel dialed its public endpoint in Oct 2026, with no key and no account of yours. The names are the server’s own.

  • evictions_get_service_overview
  • evictions_get_pricing
  • evictions_list_states
  • evictions_get_state_eviction_facts
  • evictions_get_started
  • evictions_resolve_jurisdiction
  • evictions_create_case
  • evictions_update_case
  • evictions_get_case
  • evictions_list_cases
  • evictions_validate_case
  • evictions_submit_case
  • evictions_get_case_events
  • evictions_list_case_charges
  • evictions_get_payment_link
  • evictions_list_case_messages
  • evictions_send_case_message
  • evictions_withdraw_case

Signals

Last commit
Oct 2026
Advanced
Delivery
evictions-api MCP server → your ahel connector (mcp.ahel.ai) → your AI.
Item type
mcp-server
Key
io-github-evictionsapi-evictions-api
Source
github.com/evictionsapi/evictions-api
Hosted endpoint
https://evictionsapi.com/mcp