Harringtons MCP server for AI agents
Let Claude, ChatGPT or your own agent read Harringtons: 2 typed functions through one MCP server. No Harringtons API key needed.
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just Harringtons
An MCP server for Harringtons 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/harringtonsdurhamEvery site
One MCP server for Harringtons 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 Harringtons (Durham lettings) listing from its link, slug or number: rent per person per week, deposit per person, move-in date, bedrooms…Arguments
Name Type Required listingstringA harringtonsdurham.com/properties/<slug>/ link, its slug, or its number (post id).Yes Returns
HarringtonsListinginterface HarringtonsListing { url: string; slug: string; status: "available" | "not_found"; // not_found = the site has no listing there (taken down included) title: string | null; priceAmount: number | null; // GBP, e.g. 209 priceFrequency: "pw" | "pcm" | null; pricePerPerson: boolean | null; // true for "PPPW" price: string | null; // "£209.00 PPPW" depositAmount: number | null; // GBP, e.g. 700 depositPerPerson: boolean | null; // true for "£700.00pp" availableFrom: string | null; bedrooms: number | null; bathrooms: number | null; billsIncluded: string[]; // e.g. ["broadband"] rentalType: string | null; // "House", "Flat", … facilities: string[]; // the site's own labels description: string | null; photo: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/harringtonsdurham/getListingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.harringtonsdurham.getListing({ listing: "1214613" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.harringtonsdurham.getListing({"listing": "1214613"}))curl -X POST https://api.bowmark.ai/v1/sites/harringtonsdurham/getListing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"listing":"1214613"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.harringtonsdurham.getListing({ listing: "1214613" });listListingsLists every property Harringtons advertises in Durham, filterable by street name, minimum bedrooms and maximum rent per person per week, with link…Arguments
Name Type Required querystringOptional words to match in the street / property name, e.g. "Old Elvet".No minBedroomsnumberNo maxPricenumberGBP per person per week.No limitnumberDefault 50.No Returns
HarringtonsListingsPageinterface HarringtonsListingSummary { url: string; slug: string; title: string; priceAmount: number | null; price: string | null; bedrooms: number | null; bathrooms: number | null; photo: string | null; } interface HarringtonsListingsPage { total: number; // how many matched, before limit listings: HarringtonsListingSummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/harringtonsdurham/listListingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.harringtonsdurham.listListings({ limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.harringtonsdurham.listListings({"limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/harringtonsdurham/listListings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.harringtonsdurham.listListings({ limit: 5 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/harringtonsdurham/<function> - OpenAPI
/v1/sites/harringtonsdurham/openapi.json