Zest MCP server for AI agents
Let Claude, ChatGPT or your own agent read Zest: 2 typed functions through one MCP server. No Zest API key needed.
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just Zest
An MCP server for Zest alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/zestlovespropertyEvery site
One MCP server for Zest and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 2
getListingReads one Zest letting listing by its link, slug (last part of the link) or id: status (available, let_agreed, removed.Arguments
Name Type Required listingstring | numberYes Returns
ZestListingtype ZestStatus = "available" | "let_agreed" | "removed" | "not_found"; interface ZestListing { status: ZestStatus; status_label: string | null; url: string; id: number | null; slug: string | null; title: string | null; address: { street: string | null; locality: string | null; region: string | null; postcode: string | null } | null; property_type: string | null; listing_type: "student" | "residential" | null; bedrooms: number | null; bathrooms: number | null; receptions: number | null; furnished: string | null; price_amount: number | null; price_currency: string | null; price_display: string | null; rent_frequency: "Monthly" | "Weekly" | null; features: string[]; summary: string | null; latitude: number | null; longitude: number | null; images: string[]; date_posted: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/zestlovesproperty/getListingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.zestlovesproperty.getListing({ listing: "st-peters-lodge-bath" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.zestlovesproperty.getListing({"listing": "st-peters-lodge-bath"}))curl -X POST https://api.bowmark.ai/v1/sites/zestlovesproperty/getListing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{"listing":"st-peters-lodge-bath"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.zestlovesproperty.getListing({ listing: "st-peters-lodge-bath" });searchLettingsLists Zest's Bath and Bristol properties to rent (student and residential lets) by location, department and to_let / let_agreed.Arguments
Name Type Required location"bath" | "bristol"No department"student" | "residential"No availability"to_let" | "let_agreed" | "any"No pagenumberNo Returns
ZestSearchResulttype ZestStatus = "available" | "let_agreed" | "removed" | "not_found"; interface ZestSearchRow { id: number; slug: string; link: string; title: string; status: ZestStatus; status_label: string; department: "student" | "residential" | null; property_type: string | null; location: string | null; summary: string; } interface ZestSearchResult { total: number; page: number; pages: number; listings: ZestSearchRow[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/zestlovesproperty/searchLettingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.zestlovesproperty.searchLettings({ location: "bath" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.zestlovesproperty.searchLettings({"location": "bath"}))curl -X POST https://api.bowmark.ai/v1/sites/zestlovesproperty/searchLettings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{"location":"bath"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.zestlovesproperty.searchLettings({ location: "bath" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/zestlovesproperty/<function> - OpenAPI
/v1/sites/zestlovesproperty/openapi.json