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.
- Site
- craigslist.org
- Functions
- 7
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/craigslistOne MCP server for Craigslist 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 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.
getListingReads one Craigslist listing from the URL a search returns: full description, posted and updated time, price, neighbourhood, street address and map…Arguments
Name Type Required urlstringYes Returns
CraigslistListinginterface 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/getListingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.craigslist.getListing("<url>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.craigslist.getListing("<url>"))curl -X POST https://api.bowmark.ai/v1/sites/craigslist/getListing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"<url>"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listAreasCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.craigslist.listAreas();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.craigslist.listAreas())curl -X POST https://api.bowmark.ai/v1/sites/craigslist/listAreas \ -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.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
Name Type Required areastringNo Returns
CraigslistCategory[]interface CraigslistCategory { code: string; name: string; group: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/craigslist/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.craigslist.listCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.craigslist.listCategories())curl -X POST https://api.bowmark.ai/v1/sites/craigslist/listCategories \ -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.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
Name Type Required 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
CraigslistSearchResultinterface 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/searchForSaleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.craigslist.searchForSale({ query: "bicycle", area: "sfbay", limit: 5, details: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.craigslist.searchForSale({ "query": "bicycle", "area": "sfbay", "limit": 5, "details": 2 }))curl -X POST https://api.bowmark.ai/v1/sites/craigslist/searchForSale \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"bicycle","area":"sfbay","limit":5,"details":2}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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
CraigslistSearchResultinterface 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/searchHousingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.craigslist.searchHousing({ area: "sfbay", maxPrice: 6000, limit: 5, details: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.craigslist.searchHousing({ "area": "sfbay", "maxPrice": 6000, "limit": 5, "details": 2 }))curl -X POST https://api.bowmark.ai/v1/sites/craigslist/searchHousing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"area":"sfbay","maxPrice":6000,"limit":5,"details":2}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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
CraigslistSearchResultinterface 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/searchJobsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.craigslist.searchJobs({ query: "designer", area: "losangeles", limit: 5, details: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.craigslist.searchJobs({ "query": "designer", "area": "losangeles", "limit": 5, "details": 1 }))curl -X POST https://api.bowmark.ai/v1/sites/craigslist/searchJobs \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"designer","area":"losangeles","limit":5,"details":1}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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
CraigslistSearchResultinterface 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/searchListingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.craigslist.searchListings({ query: "couch", area: "sfbay", limit: 5, details: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.craigslist.searchListings({ "query": "couch", "area": "sfbay", "limit": 5, "details": 1 }))curl -X POST https://api.bowmark.ai/v1/sites/craigslist/searchListings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"couch","area":"sfbay","limit":5,"details":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.craigslist.searchListings({ query: "couch", area: "sfbay", limit: 5, details: 1 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/craigslist/<function> - OpenAPI
/v1/sites/craigslist/openapi.json