daft-mcp

MCP server that lets AI assistants search Irish property listings on Daft.ie via the daftlistings Python library.

Requirements

• Python 3.10+
• uv (recommended) or a standard venv + pip
• git (the daftlistings dependency is installed from its master branch, which includes a fix not yet on PyPI)

Install

git clone <this-repo> daft-mcp && cd daft-mcp
uv sync          # creates .venv and installs dependencies

Run

daft-mcp                     # entry point
# or: uv run daft-mcp        # run in the project venv
# or: python -m daft_mcp.server

The server speaks MCP over stdio and waits for a client to connect.

Configure your MCP client

The examples below assume you run the client from this repo's directory. For a global config, swap . for an absolute path (e.g. /home/me/src/daft-mcp).

OpenCode

opencode mcp add        # interactive: pick local, name it "daft", use the uv command below

Or add it directly to your opencode.jsonc:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "daft": {
      "type": "local",
      "command": ["uv", "--directory", ".", "run", "daft-mcp"],
      "enabled": true
    }
  }
}

Verify with opencode mcp list, then restart OpenCode.

Claude Desktop / Claude Code

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "daft": {
      "command": "uv",
      "args": ["--directory", ".", "run", "daft-mcp"]
    }
  }
}

Codex

Add to ~/.codex/config.toml:

[mcp_servers.daft]
command = "uv"
args = ["--directory", ".", "run", "daft-mcp"]

No uv? Point the client at the venv python instead: python -m daft_mcp.server (e.g. .venv/bin/python).

Available tools

Tool	What it does
search_properties	Main search with full filtering (price, beds, type, BER, facilities, location, sort…)
suggest_locations	Fuzzy-match Daft location names from a partial query
get_search_types	List search types (residential sale, rent, commercial, sharing…)
get_property_types	List property types (houses, apartments, sites…)
get_facilities	List facility filters valid for a given search type (parking, alarm, garden…)

Example

"Find 3-bed houses for sale in Dublin City between €400k and €500k"

The assistant uses suggest_locations (if needed) and search_properties to return live Daft.ie results.

Development

uv sync                       # install dev deps if added
mypy src/                     # type checks
npx @modelcontextprotocol/inspector uv run daft-mcp   # MCP Inspector

Limitations

• daftlistings is unofficial and may break if Daft.ie changes their API.
• Results are bounded by what Daft.ie's search API returns.
• No auth required; Daft.ie may rate-limit aggressive use.

License

MIT — see LICENSE.