Accommodation for Students MCP server for AI agents
Let Claude, ChatGPT or your own agent read Accommodation for Students: 3 typed functions through one MCP server. No Accommodation for Students API key needed.
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Accommodation for Students 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/accommodationforstudentsOne MCP server for Accommodation for Students 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 Accommodation for Students listing by link or number.Arguments
Name Type Required listingstringYes Returns
AfsListinginterface AfsListing { id: string; url: string; status: "available" | "removed" | "not_found"; title: string | null; propertyType: string | null; address: { area: string | null; city: string | null; postcode: string | null } | null; priceAmount: number | null; priceFrequency: "pw"; currency: string | null; deposit: number | null; billsIncluded: string | null; bills: string[]; bedrooms: number | null; roomsAvailable: number | null; bathrooms: number | null; availableFrom: string | null; forGroupsOnly: boolean; provider: { name: string | null; type: string | null; phone: string | null } | null; rooms: { size: string | null; bed: string | null; ensuite: boolean; rentPerWeek: number | null; available: boolean }[]; amenities: string[]; description: string | null; images: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/accommodationforstudents/getListingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.accommodationforstudents.getListing("126423");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.accommodationforstudents.getListing("126423"))curl -X POST https://api.bowmark.ai/v1/sites/accommodationforstudents/getListing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"listing":"126423"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.accommodationforstudents.getListing("126423");listCitiesLists every UK city Accommodation for Students covers, with its listing count.Arguments
None.
Returns
AfsCity[]interface AfsCity { name: string; slug: string; listings: number }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/accommodationforstudents/listCitiesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.accommodationforstudents.listCities();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.accommodationforstudents.listCities())curl -X POST https://api.bowmark.ai/v1/sites/accommodationforstudents/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.accommodationforstudents.listCities();searchListingsFinds student houses, flats, studios and halls in a UK city, with weekly rent and listing links.Arguments
Name Type Required citystringYes Returns
{ city: string; totalListings: number | null; listings: AfsListingSummary[] }interface AfsListingSummary { id: string; url: string; propertyType: string; address: string; area: string | null; priceAmount: number | null; priceFrequency: "pw"; billsIncluded: string | null; roomsAvailable: number | null; provider: string | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/accommodationforstudents/searchListingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.accommodationforstudents.searchListings("York");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.accommodationforstudents.searchListings("York"))curl -X POST https://api.bowmark.ai/v1/sites/accommodationforstudents/searchListings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"city":"York"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.accommodationforstudents.searchListings("York");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/accommodationforstudents/<function> - OpenAPI
/v1/sites/accommodationforstudents/openapi.json