
Why Zillow MCP
You run comps, check what homes are worth, and track listings all day. Zillow MCP puts that data inside the AI you already talk to.
Connect once, then just ask. Add Zillow MCP to Claude, ChatGPT, OpenClaw, Hermes Agent, or any MCP client a single time, and your AI assistant can pull live Zillow property data (full property records, Zestimates, and listings) right in the conversation. No code, no repeated setup.
Ask for comps on a subject property. Check a flip's numbers against its asking price. Pull rent estimates for a cash-flow check. Or just ask what a home is worth, Zestimate, taxes, schools, and full price history come back in seconds.
Quick taste:
Find 3-bed homes for sale under $600k in Washington DC,
pull the full record for the most promising one,
and check how its Zestimate compares to the asking price.
That single prompt uses 3 of the 4 tools, search_listings, lookup_property_by_zpid, get_zestimate, without you writing a line of code.
Quick Install
Requirements:
- A Zillapi account (sign up free, 100 credits free, no card)
- An API key (
zk_...) from your dashboard OR just use OAuth (Claude, ChatGPT, Hermes Agent, OpenClaw, no key handling)
Recommended: add a rule to auto-invoke Zillow MCP
Add this rule to your AI client so you don't have to ask explicitly:
When I mention a U.S. property address, a Zillow link, or ask about home values, listings, or comps, automatically use the zillapi MCP tools to fetch real property data before answering.
Zillow MCP works with Claude Desktop and Claude Web.
Settings → Connectors → Add custom connector → paste:
https://api.zillapi.com/mcp
Claude runs the OAuth sign-in for you, no API key needed.
Prefer a key, or running headless? Add to claude_desktop_config.json instead:
{
"mcpServers": {
"zillapi": {
"transport": "streamable-http",
"url": "https://api.zillapi.com/mcp",
"headers": {
"Authorization": "Bearer zk_YOUR_KEY_HERE"
}
}
}
}
Zillow MCP works with Claude Code.
claude mcp add --transport http zillapi https://api.zillapi.com/mcp \
--header "Authorization: Bearer zk_YOUR_KEY_HERE"
Zillow MCP works with ChatGPT (Developer Mode).
- Enable Developer Mode: Settings → Apps & Connectors → Advanced settings.
- Go to Settings → Connectors → Add MCP server (Create in the Connectors panel).
- Paste the server URL:
https://api.zillapi.com/mcp
- Complete the OAuth sign-in when prompted, no API key needed.
Zillow MCP works with Hermes Agent.
Add to ~/.hermes/config.yaml under mcp_servers, with OAuth (no key handling):
mcp_servers:
zillapi:
url: "https://api.zillapi.com/mcp"
auth: oauth
Or with an API key:
mcp_servers:
zillapi:
url: "https://api.zillapi.com/mcp"
headers:
Authorization: "Bearer zk_YOUR_KEY_HERE"
With auth: oauth, Hermes runs the MCP OAuth 2.1 flow (metadata discovery + dynamic client registration) automatically, this server supports it out of the box.
Zillow MCP works with OpenClaw.
With OAuth (no key handling):
openclaw mcp add zillapi --url https://api.zillapi.com/mcp --transport streamable-http --auth oauth
openclaw mcp login zillapi
Or with an API key:
openclaw mcp set zillapi '{"url":"https://api.zillapi.com/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer zk_YOUR_KEY"}}'
Both write to ~/.openclaw/openclaw.json under mcp.servers:
{
"mcp": {
"servers": {
"zillapi": {
"url": "https://api.zillapi.com/mcp",
"transport": "streamable-http",
"auth": "oauth"
}
}
}
}
Prefer skills over MCP? Zillapi is also available as an OpenClaw-ready agent skill, grab it at ZeroPointRepo/zillow-skills.
Or manually, add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"zillapi": {
"url": "https://api.zillapi.com/mcp",
"headers": {
"Authorization": "Bearer zk_YOUR_KEY_HERE"
}
}
}
}
Or from the command line:
code --add-mcp '{"name":"zillapi","type":"http","url":"https://api.zillapi.com/mcp","headers":{"Authorization":"Bearer zk_YOUR_KEY_HERE"}}'
{
"mcpServers": {
"zillapi": {
"url": "https://api.zillapi.com/mcp",
"type": "streamableHttp",
"headers": {
"Authorization": "Bearer zk_YOUR_KEY_HERE"
}
}
}
}
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"zillapi": {
"serverUrl": "https://api.zillapi.com/mcp",
"headers": {
"Authorization": "Bearer zk_YOUR_KEY_HERE"
}
}
}
}
In Zed settings.json:
{
"context_servers": {
"zillapi": {
"source": "remote",
"url": "https://api.zillapi.com/mcp",
"headers": {
"Authorization": "Bearer zk_YOUR_KEY_HERE"
}
}
}
}
{
"mcpServers": {
"zillapi": {
"type": "streamable-http",
"url": "https://api.zillapi.com/mcp",
"headers": {
"Authorization": "Bearer zk_YOUR_KEY_HERE"
}
}
}
}
In mcp.json:
{
"mcpServers": {
"zillapi": {
"url": "https://api.zillapi.com/mcp",
"headers": {
"Authorization": "Bearer zk_YOUR_KEY_HERE"
}
}
}
}
In ~/.gemini/settings.json:
{
"mcpServers": {
"zillapi": {
"httpUrl": "https://api.zillapi.com/mcp",
"headers": {
"Authorization": "Bearer zk_YOUR_KEY_HERE"
}
}
}
}
In Settings → Tools → AI Assistant → MCP:
{
"mcpServers": {
"zillapi": {
"url": "https://api.zillapi.com/mcp",
"headers": {
"Authorization": "Bearer zk_YOUR_KEY_HERE"
}
}
}
}
Add the server as a hosted MCP tool with the URL https://api.zillapi.com/mcp and an Authorization: Bearer zk_YOUR_KEY_HERE header (or let end users OAuth). Any framework that speaks streamable-HTTP MCP works the same way.
Authentication
Two ways in, both end at the same account and credits:
- OAuth 2.1 (recommended for Claude, ChatGPT, Hermes Agent & OpenClaw): paste the endpoint (or set
auth: oauth) and sign in when prompted. The server implements Dynamic Client Registration, so DCR-aware clients discover everything automatically, you never touch a key. - API key (
zk_...): for key-based clients (Cursor, VS Code, Cline, scripts). Get one free at zillapi.com/signup and send it asAuthorization: Bearer zk_....
Security note: treat
zk_keys like passwords, never commit them to a repo or paste them into shared configs. If a key leaks, revoke it in your dashboard and mint a new one.
Available Tools
1. lookup_property_by_address
Full Zillow property record for a U.S. address, price, Zestimate, photos, schools, taxes, agent contact, and price history. 3 credits.
Real response (trimmed):
{
"data": {
"zpid": "{zpid}",
"address": { "streetAddress": "1600 Pennsylvania Ave NW", "city": "Washington", "state": "SC", "zipcode": "20500" },
"price": 415000,
"zestimate": 481100,
"rentZestimate": 2143,
"bedrooms": 4,
"bathrooms": 3,
"livingArea": 1842,
"homeStatus": "SOLD"
},
"request_id": "fb1f868e-2a10-49d8-ae01-1713ef5391e7"
}
2. lookup_property_by_zpid
Full property record by Zillow property id. 1 credit.
3. get_zestimate
Zillow's automated valuation (Zestimate) and rent Zestimate for a property.
Real response:
{
"data": {
"zestimate": 1070100,
"rent_zestimate": 8380,
"tax_assessed_value": null,
"last_sold_price": 980000,
"currency": "USD"
},
"request_id": "b2a21325-c135-40ad-9473-eeaa185b30f5"
}
4. search_listings
For-sale, for-rent, or sold listings inside a geographic bounding box, with optional bedroom and price filters. 1 credit per result, up to 50 per call.
Data you get
Every lookup returns the fields pros actually work with:
Coverage: 160M+ U.S. parcels, residential focus. Responses are JSON (CSV/NDJSON available on the REST API).
Use Cases & Prompts
Pricing & Rate Limits
- Most calls cost 1 credit per record returned;
lookup_property_by_addresscosts 3 credits; failed calls are free. - Top-ups from $4 per 1,000 credits (paid plans).
- View pricing · Sign up free
Troubleshooting
- Verify your API key starts with
zk_ - Check for extra spaces when copying the key or the endpoint URL
- Ensure the key hasn't been revoked in your Zillapi dashboard
- If using OAuth, try removing and re-adding the connector to re-authorize
- Check your credit balance in your Zillapi dashboard
- On a paid plan, buy a top-up pack; on the free tier, upgrade at zillapi.com/pricing
- Failed calls are never charged, a 402 means the account balance is empty, not that you were billed
- For address lookups, include city, state, and ZIP (e.g.
1600 Pennsylvania Ave NW, Washington DC 20500) - Verify the zpid is the numeric id from a
zillow.com/homedetails/..._zpid/URL - Some parcels (new construction, unlisted land) may not have a Zillow record yet
- Respect the
Retry-Afterheader and back off exponentially - The
error.codeis a stable string (rate_limited), detect it without parsing prose - Rate-limited calls are not charged; upgrade your plan for higher per-minute limits
- Clear browser cookies and retry the connector authorization
- Ensure popup blockers aren't stopping the sign-in window
- OAuth discovery starts from the server's 401 response, if a client can't connect, confirm it supports MCP OAuth 2.1 / DCR, or fall back to an API key
Also available as a REST API
Building an app instead of an agent? Zillapi also ships as a plain JSON REST service for Zillow property data.
Base URL: https://api.zillapi.com/v1, one real estate API for property records, valuations, and listings.
Connect
- Website: zillapi.com
- Quickstart: zillapi.com/quickstart
- API Reference: zillapi.com/api/properties
- MCP Setup Guides: Claude Desktop · Claude Code · Cursor · For AI agents
- Contact: [email protected]
MCP Registry
Published to the official Model Context Protocol Registry as:
com.zillapi/zillow-mcp
FAQ
Is there a public Zillow API in 2026? Not an open one, Zillow retired its public API (ZWSID) in 2021, and official access now runs through Bridge Interactive, which is MLS-gated. Zillow MCP provides same-day, self-serve access to Zillow-sourced property data through the Model Context Protocol, with a free tier and no approval process.
What is a Zillow MCP? A Zillow MCP is a Model Context Protocol server that exposes Zillow property data as tools an AI agent can call: property lookup by address or zpid, Zestimates, and listing search, so assistants like Claude, ChatGPT, OpenClaw, and Hermes Agent can fetch live U.S. property data mid-conversation, backed by Zillapi's hosted property data API.
How do I add it to Claude Desktop, Claude Code, or ChatGPT?
Claude Desktop: Settings → Connectors → Add custom connector → paste https://api.zillapi.com/mcp. Claude Code: claude mcp add --transport http zillapi https://api.zillapi.com/mcp --header "Authorization: Bearer zk_YOUR_KEY". ChatGPT: enable Developer Mode, then Settings → Connectors → Add MCP server → paste the URL and complete the OAuth prompt. See Quick Install for every client.
Can it run comps or a quick CMA? Yes, that's the core workflow. Ask for recently sold homes near a subject property, then compare sale prices, Zestimates, and price per sqft. Agents use it for quick CMAs; investors run the same flow for flip margins and rental yield checks.
How much does it cost? 100 free credits at signup with no card. After that it's credit-based, monthly/annual plans or top-ups from $4 per 1,000 credits. Most calls are 1 credit per record; address lookups are 3 credits; failed calls are free.
Is this affiliated with Zillow? No. Zillapi is an independent service and is not affiliated with, endorsed by, or sponsored by Zillow Group, Inc. "Zillow" and "Zestimate" are trademarks of Zillow Group, Inc., used here descriptively to refer to those services.
