StuRents MCP server for AI agents
Let Claude, ChatGPT or your own agent read StuRents: 2 typed functions through one MCP server. No StuRents API key needed.
- Site
- sturents.com
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just StuRents
An MCP server for StuRents 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/sturentsEvery site
One MCP server for StuRents 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 StuRents student accommodation listing by link or number: status, address, bedrooms, amenities and every tenancy option with rent per…Arguments
Name Type Required listingstringA sturents.com listing link, or its number, e.g. "380382".Yes contractstringOptional contract id (the link's ?contract=) to use as headline.No Returns
SturentsListinginterface SturentsContract { contractId: string; label: string | null; // "51 Weeks 27/28" priceAmount: number | null; // GBP per person per week rent: string | null; // "£215 pppw (£1,290 property/week)" deposit: string | null; // "£0 pp" billsIncluded: string[]; // ["Gas", "Electricity", …] beds: string | null; rentalType: string | null; dates: Record<string, string>; // { "Move in": "10 Sep 2027", "Move out": "31 Aug 2028", … } bookNow: boolean; } interface SturentsListing { id: string; url: string; status: "available" | "unavailable" | "not_found"; title: string | null; description: string | null; address: string | null; postcode: string | null; city: string | null; bedrooms: number | null; bathrooms: number | null; photo: string | null; amenities: string[]; // the site's own labels, read the values off a result, never guess one from prose headline: SturentsContract | null; contracts: SturentsContract[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/sturents/getListingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.sturents.getListing({ listing: "380382" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.sturents.getListing({"listing": "380382"}))curl -X POST https://api.bowmark.ai/v1/sites/sturents/getListing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"listing":"380382"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.sturents.getListing({ listing: "380382" });listListingsLists the student houses and flats StuRents shows first for a UK city, with link, beds, lowest rent per person per week, available-from date and…Arguments
Name Type Required citystringA UK city, e.g. "Bath", "London", "Leeds".Yes Returns
SturentsListingsPageinterface SturentsListingSummary { id: string; url: string; title: string; city: string | null; address: string | null; beds: string | null; fromPrice: string | null; availableFrom: string | null; landlord: string | null; contractsCount: number | null; } interface SturentsListingsPage { city: string; total: number | null; listings: SturentsListingSummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/sturents/listListingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.sturents.listListings({ city: "Bath" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.sturents.listListings({"city": "Bath"}))curl -X POST https://api.bowmark.ai/v1/sites/sturents/listListings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"city":"Bath"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.sturents.listListings({ city: "Bath" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/sturents/<function> - OpenAPI
/v1/sites/sturents/openapi.json