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.

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/spareroom
Every 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/mcp
Set it up in your client

Both 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

    NameTypeRequired
    listingstring
    An ad link (…flatshare_detail.pl?flatshare_id=17308434) or its reference number "17308434".
    Yes

    Returns SpareroomListing

    interface 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/getListing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    locationstring
    A UK town, area, postcode or tube station, e.g. "Manchester" or "SE15".
    Yes
    minRentnumber
    Rent bounds in GBP, in the 'per' period.
    No
    maxRentnumberNo
    per"pcm" | "pw"
    "pcm" (default) or "pw".
    No
    offsetnumber
    Result offset; pages are 10 ads.
    No

    Returns SpareroomSearchResult

    interface 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/searchRooms

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.spareroom.searchRooms({ location: "Manchester" });

Use it from code