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/nicholashumphreys
Every 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/mcp
Set it up in your client

Both 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

    NameTypeRequired
    listingstring | numberYes

    Returns NicholasHumphreysListing

    type 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/getListing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    locationstringNo
    department"student" | "residential"No
    bedroomsnumberNo
    sort"newest" | "price_asc" | "price_desc"No
    pagenumberNo

    Returns NicholasHumphreysSearchResult

    type 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/searchLettings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nicholashumphreys.searchLettings({ location: "Leicester" });

Use it from code