Evictions API — public examples
MCP serverDev toolsUS/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
Needs your own account with this service. Keys stay in your vault.
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.
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/mcpAdd 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/mcpIn 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.
- 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:
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
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
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_overviewevictions_get_pricingevictions_list_statesevictions_get_state_eviction_factsevictions_get_startedevictions_resolve_jurisdictionevictions_create_caseevictions_update_caseevictions_get_caseevictions_list_casesevictions_validate_caseevictions_submit_caseevictions_get_case_eventsevictions_list_case_chargesevictions_get_payment_linkevictions_list_case_messagesevictions_send_case_messageevictions_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
github.com/evictionsapi/evictions-api