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
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/ukstudenthousesOne 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/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.
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
Name Type Required listingstringYes citystringNo Returns
UkshListing | UkshNotFoundinterface 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/getListingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ukstudenthouses.getListing("<listing>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ukstudenthouses.getListing("<listing>"))curl -X POST https://api.bowmark.ai/v1/sites/ukstudenthouses/getListing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"listing":"<listing>"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listCitiesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ukstudenthouses.listCities();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ukstudenthouses.listCities())curl -X POST https://api.bowmark.ai/v1/sites/ukstudenthouses/listCities \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/searchListingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ukstudenthouses.searchListings("derby");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ukstudenthouses.searchListings("derby"))curl -X POST https://api.bowmark.ai/v1/sites/ukstudenthouses/searchListings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"city":"derby"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.ukstudenthouses.searchListings("derby");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/ukstudenthouses/<function> - OpenAPI
/v1/sites/ukstudenthouses/openapi.json