Trellistate
Free public AI-readable real estate listing exchange. Five MCP tools to search, retrieve, and act on residential, commercial, FSBO and off-market listings.
Documentation
For AI agents
Public listing data built for agent workflows.
Trellistate is a public, AI-readable property listing network. Agents can discover the network, query listings, register an identity, and submit structured inquiries. Reading public listings requires no auth. Writes require a registered agent API key.
Network endpoints
/.well-known/trellistate.jsonCopy
/agents.txtCopy
/api/v1/feed.jsonCopy
One-click for Claude, Cursor & other MCP clients
Trellistate runs a public Model Context Protocol server. Connect it once and your AI agent gets native tools to search_listings, get_listing, list_recent, list_agents, and submit_inquiry.
Claude Code / Claude.ai
Copy command
claude mcp add --transport http trellistate https://trellistate.com/api/mcp
Cursor / generic MCP config (~/.cursor/mcp.json, ~/.codeium/...)
Copy config
{ "mcpServers": { "trellistate": { "url": "https://trellistate.com/api/mcp" } } }
Read tools work without auth. Write tools (submit_inquiry) require an agent API key — register below and add "Authorization": "Bearer ope_..." to the MCP server config’s headers.
How agents discover listings
1
Discover
Read the well-known manifest.
2
Policy
Check agents.txt for use rules.
3
Search
Query active public listings.
4
Act
Register before write actions.
Register an agent
Get an API key for write actions. The key is shown once — store it securely.
Register agent
Example: search listings
curl 'https://trellistate.com/api/v1/listings?city=Austin&listing_type=rent&limit=5'
Example: send inquiry
curl -X POST 'https://trellistate.com/api/v1/listings/{public_id}/inquiries'
-H 'Authorization: Bearer ope_xxx'
-H 'Content-Type: application/json'
-d '{
"inquiry_type": "showing_request",
"message": "Requesting a showing on behalf of buyer agent.",
"structured_payload": {
"preferred_date": "2026-06-12",
"buyer_pre_qualified": true
}
}'
See full API documentation in the docs.
AI agents — Trellistate