Metadata-Version: 2.4
Name: apillow-mcp
Version: 0.1.3
Summary: MCP server for Apillow — Zillow property data API. Search properties, get Zestimates, price history, and more directly from AI agents.
Author-email: Apillow <adam@bobbyseamoss.com>
License-Expression: MIT
Project-URL: Homepage, https://apillow.co
Project-URL: Documentation, https://apillow.co/docs.html#mcp-install
Project-URL: Guide, https://apillow.co/blog/zillow-mcp-server
Keywords: mcp,zillow,real-estate,property-data,api
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0
Requires-Dist: httpx>=0.27

# Apillow MCP Server

Zillow property data for AI agents. Search properties, get Zestimates, price history, school ratings, and more — directly from Claude, Cursor, or any MCP-compatible AI tool.

<!-- mcp-name: co.apillow/zillow -->

## Quick Start

```bash
pip install apillow-mcp
```

### Claude Desktop

Add to `~/.claude/claude_desktop_config.json`:

```json
{
    "mcpServers": {
        "apillow": {
            "command": "apillow-mcp",
            "env": {
                "APILLOW_API_KEY": "your_key_here"
            }
        }
    }
}
```

No API key yet? The agent can create one for you — just ask it to sign up.

### Claude Code

```bash
claude mcp add apillow -- apillow-mcp
```

## Tools

### Property Data

| Tool | Description |
|---|---|
| `search_properties` | Search by city or area (e.g. "Austin TX") |
| `search_by_zip` | Search by ZIP codes (e.g. [90210]) |
| `get_property` | Look up by Zillow Property ID |
| `get_property_by_url` | Get data from a Zillow listing URL |

### Account

| Tool | Description |
|---|---|
| `signup` | Create free account (50 req/month), get API key instantly |
| `check_usage` | See current usage, quota, and plan details |
| `upgrade_plan` | Get a Stripe payment link to upgrade your plan |

## Example Conversation

> **You:** Find me 3-bedroom homes under $500K in Austin TX

> **Agent:** *calls search_properties("Austin TX", type="sale", max_items=10)*
> I found 8 listings. Here are the top options under $500K...

> **You:** What schools are near that first property?

> **Agent:** *calls get_property(zpid=12345678)*
> There are 3 nearby schools: Austin Elementary (rating 8/10), ...

## Pricing

- **Free**: 50 requests/month (sign up through the agent)
- **Pro**: $9.99/mo — 3,333 requests
- **Ultra**: $29.99/mo — 10,000 requests
- **Mega**: $99.99/mo — 50,000 requests

## Links

- Website: https://apillow.co
- API Docs: https://apillow.co/docs.html
- Guide: https://apillow.co/blog/zillow-mcp-server
- RapidAPI: https://rapidapi.com/info-UzmhEs339/api/zillow-property-data1
