Student Homes MCP server for AI agents
Let Claude, ChatGPT or your own agent read Student Homes: 2 typed functions through one MCP server. No Student Homes API key needed.
- Site
- studenthomes.net
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just Student Homes
An MCP server for Student Homes 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/studenthomes_netEvery site
One MCP server for Student Homes 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 Student Homes listing by link or number: availability, weekly rent per person with and without bills, deposit, rooms, description and…Arguments
Name Type Required listingstringYes Returns
StudentHomesListinginterface StudentHomesPrice { weeklyPerPerson: number | null; weeklyPerPersonInclBills: number | null; monthlyPerPerson: number | null; monthlyPerPersonInclBills: number | null; monthlyTotal: number | null; monthlyTotalInclBills: number | null; deposit: number | null; currency: "GBP" } interface StudentHomesListing { id: string; url: string; status: "available" | "not_found"; availability: string | null; title: string | null; area: string | null; heading: string | null; priceAmount: number | null; priceFrequency: "pppw"; billsIncluded: boolean; price: StudentHomesPrice; bedrooms: number | null; bathrooms: number | null; receptions: number | null; furnishing: string | null; features: string[]; description: string | null; images: string[]; phone: string | null; reserveUrl: string | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/studenthomes_net/getListingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.studenthomes_net.getListing("33556535");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.studenthomes_net.getListing("33556535"))curl -X POST https://api.bowmark.ai/v1/sites/studenthomes_net/getListing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"listing":"33556535"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.studenthomes_net.getListing("33556535");searchListingsSearches Student Homes' student houses and flats by town and bedroom range, 12 a page, with weekly rent per person and listing links.Arguments
Name Type Required location"Coventry" | "Kenilworth" | "Leamington Spa" | "Leicester" | "Liverpool" | "Manchester" | "Southampton" | "Warwick"No minBedroomsnumberNo maxBedroomsnumberNo sort"price_desc" | "price_asc"No pagenumberNo Returns
StudentHomesSearchResultinterface StudentHomesListingSummary { id: string; url: string; title: string; area: string | null; availability: string | null; bedrooms: number | null; bathrooms: number | null; features: string[]; priceAmount: number | null; weeklyPerPersonExclBills: number | null; billsIncluded: boolean; monthlyTotalInclBills: number | null; deposit: number | null; image: string | null } interface StudentHomesSearchResult { page: number; totalPages: number; listings: StudentHomesListingSummary[] }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/studenthomes_net/searchListingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.studenthomes_net.searchListings({ location: "Leamington Spa" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.studenthomes_net.searchListings({"location": "Leamington Spa"}))curl -X POST https://api.bowmark.ai/v1/sites/studenthomes_net/searchListings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"location":"Leamington Spa"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.studenthomes_net.searchListings({ location: "Leamington Spa" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/studenthomes_net/<function> - OpenAPI
/v1/sites/studenthomes_net/openapi.json