Nicholas Humphreys MCP server for AI agents
Let Claude, ChatGPT or your own agent read Nicholas Humphreys: 2 typed functions through one MCP server. No Nicholas Humphreys API key needed.
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just Nicholas Humphreys
An MCP server for Nicholas Humphreys 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/nicholashumphreysEvery site
One MCP server for Nicholas Humphreys 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 Nicholas Humphreys letting listing in full by its link, postId or reference: status (available, let_agreed incl.Arguments
Name Type Required listingstring | numberYes Returns
NicholasHumphreysListingtype NicholasHumphreysStatus = "available" | "let_agreed" | "let" | "not_found"; interface NicholasHumphreysListing { status: NicholasHumphreysStatus; status_label: string | null; url: string; postId: number | null; reference: string | null; title: string | null; property_type: string | null; listing_type: string | null; bedrooms: number | null; bathrooms: number | null; price_amount: number | null; price_currency: string | null; price_display: string | null; rent_frequency: string | null; deposit: number | null; features: string[]; description: string | null; address: { street: string | null; locality: string | null; postcode: string | null } | null; latitude: number | null; longitude: number | null; images: string[]; date_posted: string | null; branch: { name: string | null; phone: string | null } | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nicholashumphreys/getListingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nicholashumphreys.getListing({ listing: "78726625-651" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nicholashumphreys.getListing({"listing": "78726625-651"}))curl -X POST https://api.bowmark.ai/v1/sites/nicholashumphreys/getListing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{"listing":"78726625-651"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nicholashumphreys.getListing({ listing: "78726625-651" });searchLettingsSearches Nicholas Humphreys' student and residential properties to rent by town or postcode, bedrooms and department, eight per page.Arguments
Name Type Required locationstringNo department"student" | "residential"No bedroomsnumberNo sort"newest" | "price_asc" | "price_desc"No pagenumberNo Returns
NicholasHumphreysSearchResulttype NicholasHumphreysStatus = "available" | "let_agreed" | "let" | "not_found"; interface NicholasHumphreysSearchRow { postId: number; reference: string; link: string; address: string; town: string; postcode: string; status: NicholasHumphreysStatus; status_label: string; department: string; property_type: string; furnishing: string | null; bedrooms: number | null; bathrooms: number | null; price_amount: number | null; rent_frequency: string | null; deposit: number | null; available_from: string | null; bills_included: boolean; features: string[]; summary: string; latitude: number | null; longitude: number | null; image: string | null; } interface NicholasHumphreysSearchResult { total: number; page: number; pages: number; listings: NicholasHumphreysSearchRow[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nicholashumphreys/searchLettingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nicholashumphreys.searchLettings({ location: "Leicester" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nicholashumphreys.searchLettings({"location": "Leicester"}))curl -X POST https://api.bowmark.ai/v1/sites/nicholashumphreys/searchLettings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{"location":"Leicester"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nicholashumphreys.searchLettings({ location: "Leicester" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/nicholashumphreys/<function> - OpenAPI
/v1/sites/nicholashumphreys/openapi.json