Craigslist MCP server for AI agents

Let Claude, ChatGPT or your own agent read Craigslist: 7 typed functions through one MCP server. No Craigslist API key needed.

Functions
7
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Craigslist

An MCP server for Craigslist 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/craigslist
Every site

One MCP server for Craigslist 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 that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 7
  • getListingReads one Craigslist listing from the URL a search returns: full description, posted and updated time, price, neighbourhood, street address and map…

    Arguments

    NameTypeRequired
    urlstringYes

    Returns CraigslistListing

    interface CraigslistListing { id: string; title: string; price: string | null; priceAmount: number | null; location: string | null; url: string; description: string | null; postedAt: string | null; updatedAt: string | null; attributes: string[]; bedrooms: number | null; bathrooms: number | null; squareFeet: number | null; address: string | null; latitude: number | null; longitude: number | null; images: string[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/craigslist/getListing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.craigslist.getListing("<url>");
  • listAreasLists Craigslist's areas (cities and regions worldwide) with the code the search functions take as area, e.g. sfbay, newyork, losangeles.

    Arguments

    None.

    Returns CraigslistArea[]

    interface CraigslistArea { code: string; name: string; url: string; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/craigslist/listAreas

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.craigslist.listAreas();
  • listCategoriesLists Craigslist's category tree (housing, for sale, jobs, services, gigs, community) with the three-letter code each search takes as category.

    Arguments

    NameTypeRequired
    areastringNo

    Returns CraigslistCategory[]

    interface CraigslistCategory { code: string; name: string; group: string; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/craigslist/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.craigslist.listCategories();
  • searchForSaleFinds used items for sale on Craigslist in a city or area (San Francisco, New York, Los Angeles and 700 more) by keyword, price range and category…

    Arguments

    NameTypeRequired
    argsstring | CraigslistSearchArgsYes
    interface CraigslistSearchArgs { query?: string; area?: string; category?: string; minPrice?: number; maxPrice?: number; sort?: "date" | "priceasc" | "pricedsc" | "rel"; postal?: string; distanceMiles?: number; limit?: number; details?: boolean | number; }

    Returns CraigslistSearchResult

    interface CraigslistListing { id: string; title: string; price: string | null; priceAmount: number | null; location: string | null; url: string; description: string | null; postedAt: string | null; updatedAt: string | null; attributes: string[]; bedrooms: number | null; bathrooms: number | null; squareFeet: number | null; address: string | null; latitude: number | null; longitude: number | null; images: string[]; }
    
    interface CraigslistSearchResult { query: string; area: string; category: string; url: string; total: number; detailed: number; listings: CraigslistListing[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/craigslist/searchForSale

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.craigslist.searchForSale({ query: "bicycle", area: "sfbay", limit: 5, details: 2 });
  • searchHousingFinds apartments and housing for rent on Craigslist in a city or area (San Francisco Bay Area by default, New York, Los Angeles, Seattle, Chicago and…

    Arguments

    NameTypeRequired
    argsstring | CraigslistHousingArgsNo
    interface CraigslistSearchArgs { query?: string; area?: string; category?: string; minPrice?: number; maxPrice?: number; sort?: "date" | "priceasc" | "pricedsc" | "rel"; postal?: string; distanceMiles?: number; limit?: number; details?: boolean | number; }
    
    interface CraigslistHousingArgs extends CraigslistSearchArgs { kind?: string; minBedrooms?: number; maxBedrooms?: number; bedrooms?: number; minBathrooms?: number; pets?: "cats" | "dogs" | boolean; }

    Returns CraigslistSearchResult

    interface CraigslistListing { id: string; title: string; price: string | null; priceAmount: number | null; location: string | null; url: string; description: string | null; postedAt: string | null; updatedAt: string | null; attributes: string[]; bedrooms: number | null; bathrooms: number | null; squareFeet: number | null; address: string | null; latitude: number | null; longitude: number | null; images: string[]; }
    
    interface CraigslistSearchResult { query: string; area: string; category: string; url: string; total: number; detailed: number; listings: CraigslistListing[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/craigslist/searchHousing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.craigslist.searchHousing({ area: "sfbay", maxPrice: 6000, limit: 5, details: 2 });
  • searchJobsFinds job postings or gigs on Craigslist in a city or area (San Francisco, New York, Los Angeles and 700 more) by keyword, job category and remote…

    Arguments

    NameTypeRequired
    argsstring | CraigslistJobsArgsYes
    interface CraigslistSearchArgs { query?: string; area?: string; category?: string; minPrice?: number; maxPrice?: number; sort?: "date" | "priceasc" | "pricedsc" | "rel"; postal?: string; distanceMiles?: number; limit?: number; details?: boolean | number; }
    
    interface CraigslistJobsArgs extends CraigslistSearchArgs { kind?: "jobs" | "gigs"; remote?: boolean; }

    Returns CraigslistSearchResult

    interface CraigslistListing { id: string; title: string; price: string | null; priceAmount: number | null; location: string | null; url: string; description: string | null; postedAt: string | null; updatedAt: string | null; attributes: string[]; bedrooms: number | null; bathrooms: number | null; squareFeet: number | null; address: string | null; latitude: number | null; longitude: number | null; images: string[]; }
    
    interface CraigslistSearchResult { query: string; area: string; category: string; url: string; total: number; detailed: number; listings: CraigslistListing[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/craigslist/searchJobs

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.craigslist.searchJobs({
      query: "designer",
      area: "losangeles",
      limit: 5,
      details: 1
    });
  • searchListingsSearches any Craigslist category (for sale by default) in an area by keyword, price range, sort and ZIP radius, returning price, neighbourhood…

    Arguments

    NameTypeRequired
    argsstring | CraigslistSearchArgsYes
    interface CraigslistSearchArgs { query?: string; area?: string; category?: string; minPrice?: number; maxPrice?: number; sort?: "date" | "priceasc" | "pricedsc" | "rel"; postal?: string; distanceMiles?: number; limit?: number; details?: boolean | number; }

    Returns CraigslistSearchResult

    interface CraigslistListing { id: string; title: string; price: string | null; priceAmount: number | null; location: string | null; url: string; description: string | null; postedAt: string | null; updatedAt: string | null; attributes: string[]; bedrooms: number | null; bathrooms: number | null; squareFeet: number | null; address: string | null; latitude: number | null; longitude: number | null; images: string[]; }
    
    interface CraigslistSearchResult { query: string; area: string; category: string; url: string; total: number; detailed: number; listings: CraigslistListing[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/craigslist/searchListings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.craigslist.searchListings({ query: "couch", area: "sfbay", limit: 5, details: 1 });

Use it from code