SpareRoom MCP server for AI agents
Let Claude, ChatGPT or your own agent read SpareRoom: 2 typed functions through one MCP server. No SpareRoom API key needed.
- Site
- spareroom.co.uk
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just SpareRoom
An MCP server for SpareRoom 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/spareroomEvery site
One MCP server for SpareRoom 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 SpareRoom ad offering a room or a whole property, from its link or reference number: status (available, unavailable when now let, removed…Arguments
Name Type Required listingstringAn ad link (…flatshare_detail.pl?flatshare_id=17308434) or its reference number "17308434".Yes Returns
SpareroomListinginterface SpareroomRoom { name: string; rent: number | null; rentPeriod: "pcm" | "pw" | null; deposit: number | null; status: "available" | "let"; } interface SpareroomListing { id: string; url: string; status: "available" | "unavailable" | "removed" | "not_found"; title: string | null; description: string | null; propertyType: string | null; // the ad's first key feature, e.g. "House share" area: string | null; postcode: string | null; latitude: number | null; longitude: number | null; /** The cheapest room still available, GBP. */ priceAmount: number | null; priceFrequency: "pcm" | "pw" | null; billsIncluded: boolean | null; rooms: SpareroomRoom[]; availability: Record<string, string>; extraCost: Record<string, string>; amenities: Record<string, string>; currentHousehold: Record<string, string>; housematePreferences: Record<string, string>; image: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spareroom/getListingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spareroom.getListing({ listing: "1361537" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spareroom.getListing({"listing": "1361537"}))curl -X POST https://api.bowmark.ai/v1/sites/spareroom/getListing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"listing":"1361537"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spareroom.getListing({ listing: "1361537" });searchRoomsSearches SpareRoom (spareroom.co.uk), the UK flatshare and room-to-rent site, for rooms offered in a town, area, postcode or tube station.Arguments
Name Type Required locationstringA UK town, area, postcode or tube station, e.g. "Manchester" or "SE15".Yes minRentnumberRent bounds in GBP, in the 'per' period.No maxRentnumberNo per"pcm" | "pw""pcm" (default) or "pw".No offsetnumberResult offset; pages are 10 ads.No Returns
SpareroomSearchResultinterface SpareroomSearchRow { id: string; title: string; /** Pass to getListing({ listing }). */ url: string; type: string; neighbourhood: string | null; postcode: string | null; propertyType: string | null; // the site's own label, e.g. "house" roomsInProperty: number | null; advertiserRole: string | null; /** GBP, as the ad states it. */ rent: number | null; rentPeriod: "pcm" | "pw" | null; rentNormalised: number | null; rentNormalisedPeriod: "pcm" | "pw" | null; availableNow: boolean; daysOld: number | null; photos: number; image: string | null; promotion: string | null; } interface SpareroomSearchResult { location: string; /** Total ads the site reports. */ total: number | null; offset: number; rooms: SpareroomSearchRow[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spareroom/searchRoomsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spareroom.searchRooms({ location: "Manchester" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spareroom.searchRooms({"location": "Manchester"}))curl -X POST https://api.bowmark.ai/v1/sites/spareroom/searchRooms \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"location":"Manchester"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spareroom.searchRooms({ location: "Manchester" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/spareroom/<function> - OpenAPI
/v1/sites/spareroom/openapi.json