UK Student Houses MCP server for AI agents

Let Claude, ChatGPT or your own agent read UK Student Houses: 3 typed functions through one MCP server. No UK Student Houses API key needed.

Functions
3
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just UK Student Houses

An MCP server for UK Student Houses 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/ukstudenthouses
Every site

One MCP server for UK Student Houses 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 3
  • getListingReads one UK Student Houses listing in full by its link, or its number plus city: status (available; let when every room is taken; not_found), title…

    Arguments

    NameTypeRequired
    listingstringYes
    citystringNo

    Returns UkshListing | UkshNotFound

    interface UkshContract { title: string; startDate: string | null; endDate: string | null; pricePerPersonPerWeek: number | null; deposit: number | null; viewingUrl: string | null; }
    
    interface UkshListing { id: string; city: string; url: string; status: "available" | "let"; title: string; address: string | null; propertyType: string; bedrooms: number | null; bathrooms: number | null; roomsAvailable: number | null; roomsLetIndividually: boolean; pricePerPersonPerWeek: number | null; contracts: UkshContract[]; amenities: string[]; description: string | null; photos: string[]; coordinates: { lat: number; lng: number } | null; }
    
    interface UkshNotFound { id: string; city: string | null; status: "not_found"; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ukstudenthouses/getListing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ukstudenthouses.getListing("<listing>");
  • listCitiesLists the cities UK Student Houses lets student houses in, with the slug searchListings takes.

    Arguments

    None.

    Returns UkshCity[]

    interface UkshCity { name: string; slug: string; url: string; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ukstudenthouses/listCities

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ukstudenthouses.listCities();
  • searchListingsLists the student houses UK Student Houses lets in one city: listing number, link, postcode, bedrooms, bathrooms, from-price per person per month and…

    Arguments

    NameTypeRequired
    citystringYes

    Returns UkshListingCard[]

    interface UkshListingCard { id: string; city: string; url: string; name: string; postcode: string | null; bedrooms: number | null; bathrooms: number | null; priceFromPerPersonPerMonth: number | null; availability: string | null; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ukstudenthouses/searchListings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ukstudenthouses.searchListings("derby");

Use it from code