Pythia Property — Documentation

Property values, rent estimates, market stats, and investment deal analysis for 140M+ US properties, via the Model Context Protocol. Built for AI assistants.

Connect

MCP endpoint: https://api.pythiaprediction.com/mcp (Streamable HTTP)

Claude Code

claude mcp add --transport http pythia https://api.pythiaprediction.com/mcp

Claude (web / desktop)

Settings → Connectors → Add custom connector → paste the endpoint URL. Free tools work immediately, no sign-in. To use Pro tools, click connect/authorize and paste your Pythia Pro API key.

ChatGPT & other MCP clients

Add a remote MCP server with the same URL. For Pro tools, supply your key as the api_key parameter or an X-API-Key header.

Tools

ToolTierWhat it does
get_housing_market_statsfreeSale & rental housing market stats for a US ZIP — average/median price & rent, $/sqft, days on market, inventory.
lookup_property_recordfreePublic real estate record by street address: beds/baths/sqft, year built, lot, last sale, tax history. 3/day free; high monthly limits on Pro.
estimate_valueproHome value estimate (AVM) + value range + comparable sales.
estimate_rentproMarket rent estimate (AVM) + range + rental comps.
analyze_rental_dealproFull rental-investment analysis: value vs asking, cash flow, cap rate, cash-on-cash, break-even rent, AVM confidence band, risk flags. All assumptions overridable.

All tools are read-only. Addresses use the format Street, City, State, Zip. Pythia analyzes properties and markets only — never people; there are no tenant-screening or applicant-evaluation tools.

Example prompts

"What's the average rent for a 2-bedroom in 78704?" free

"Tell me about 5500 Grand Lake Dr, San Antonio TX." free

"What's 1234 Maple Ave, Columbus OH worth?" pro

"Analyze this deal: 456 Oak St, Tampa FL at $389,000 with 20% down." pro

Pro & billing

Pythia Property Pro is $25/month. Subscribe at pythiaprediction.com/subscribe — you receive an API key instantly, and can authorize your assistant via OAuth or use the key directly. Manage or cancel anytime at /manage.

Plans & usage limits

Limits apply to live (uncached) lookups — repeat questions about the same property or zip are served from cache and don't count. A full deal analysis uses ~3 live lookups; a single value or rent estimate uses ~1.

PlanPriceLive-lookup limit≈ deal analyses
Free$0Market stats (any zip) + 3 property records/day
Day Pass$9 / 24h~60 live lookups~20
Pro$25/mo~300 live lookups/month~100

Limits are deliberately generous for real use; they exist to keep the service fast and sustainable and to prevent automated abuse. Hit a limit? You'll get a clear message (not an error), cached results still work, and Pro resets monthly. High-volume need (data teams, large brokerages)? Email support@pythiaprediction.com about an enterprise plan.

Errors, caching & rate limits

Tools return clear, human-readable messages (e.g. "No property record found — check the address format"), never bare errors. Burst rate limit: 60 requests/min (free) / 240/min (Pro). Data is cached (market stats 30d, records 30d, estimates 7d) and labeled with a data_as_of timestamp, so common questions are instant and free.

Data & disclaimers

Property data is provided by RentCast. All values and analyses are informational estimates — not investment, lending, or housing-eligibility advice. See Terms and Privacy. Support: support@pythiaprediction.com.