Zoopla

Provides access to Zoopla listings, prices, agents, and related data via MCP using a Zoopla API key.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "bach-ai-tools-bachai-zoopla": {
      "command": "uvx",
      "args": [
        "--from",
        "bach-zoopla",
        "bach_zoopla"
      ],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

This Zoopla MCP Server enables you to access Zoopla API data through a lightweight MCP interface. It provides pre-packaged, plug-and-play ways to run the server locally or via an MCP platform, making it simple to integrate Zoopla listings and pricing data into your applications.

How to use

You will run this MCP server as a local or remote service and connect to it through an MCP client. You can start the server using a runtime that communicates via stdio, and you will provide your API key through environment variables. Use the MCP client to load the server, then query endpoints such as property listings, agent details, and price estimates.

How to install

Prerequisites you need before installation:

Python 3.x installed
pip installed
Access to an MCP client (optional but recommended)

Install the Zoopla MCP package from PyPI:

pip install bach-zoopla

Option A: Run via uvx (recommended) without installation of additional runtimes:

uvx --from bach-zoopla bach_zoopla

# or to specify the latest version
uvx --from bach-zoopla@latest bach_zoopla

Option B: Run in development mode using Python directly (develop mode):

python server.py

Option C: After installation, you can run the command directly (the executable name uses underscores):

# Install (if not already installed)
pip install bach-zoopla

# Run the command
bach_zoopla

Additional configuration and usage notes

API authentication is required. You must set your Zoopla API key in an environment variable before starting the server.

Environment variable to set:

export API_KEY="your_api_key_here"

Available tools

propertiesv2list

List properties for sale or rent with various filters and options using the Zoopla API.

house_pricesv2estimate

Return estimated house prices for a given area or geo identifier.

agentsdetail

Fetch detailed information about an agent by their id.

agentslist

List agents with filters like location, radius, and type (estate, letting, or commercial).

house_pricesv2detail

Get detailed property price information for a specific listing.

house_pricesv2auto_complete

Get auto-complete suggestions for city, area, or district queries.

v2auto_complete

Get auto-complete suggestions for terms or phrases related to listings.