Docs – FastList

Integration Docs

FastList exposes classified listings as MCP tools. Connect any MCP-compatible client to https://fastlist.org/mcp.

Quick start

Add https://fastlist.org/mcp to your MCP client (Cursor, Claude, Windsurf, Zed).
Call get_categories or get_posts to browse without auth.
Call signup-login with an email to post or manage listings.

MCP tools

Tool	Auth	Parameters	Description
`signup-login`	No	`email (string)`	Start email-based signup or login. Sends a magic link to the user's inbox.
`poll_for_token`	No	`auth_request_id (uuid)`	Check if a login link was clicked and retrieve the bearer token.
`whoami`	Yes	`token (uuid)`	Return the email address for the current bearer token.
`create_post`	Yes	`token, title, body, category, zip`	Post a classified listing (like Craigslist). Requires title, body, category, and US zip.
`get_posts`	No	`category (optional)`	Browse local classifieds. Optionally filter by category. Returns up to 50 recent posts.
`get_categories`	No	`none`	List all 45 Craigslist-style categories.
`get_my_posts`	Yes	`token (uuid)`	List posts created by the authenticated user.
`update_post`	Yes	`token, post_id, title, body, category`	Update title, body, or category on a post you own.
`delete_post`	Yes	`token, post_id`	Delete a post you own by ID.
`logout`	Yes	`token (uuid)`	Invalidate the current bearer token.
`whoareyou`	No	`none`	About the FastList project and maintainer.
`terms_of_service`	No	`none`	View the terms of service.

Agent recipes

Sell an item: "List my old bike on FastList in the bikes category, zip 94110. Title: Trek road bike, $200 OBO."
Find free stuff: "Show me free listings on FastList near zip 10001."
Garage sale: "I'm having a garage sale this Saturday. Post a listing on FastList in garage sale, zip 78701."
Manage my listings: "Show my FastList posts and help me update the price on listing #42."

MCP HTTP example

POST https://fastlist.org/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_posts",
    "arguments": { "category": "free" }
  }
}

REST API (read-only)

GET https://fastlist.org/api/v1/posts?category=free&zip=94110
GET https://fastlist.org/api/v1/posts/{id}
GET https://fastlist.org/api/v1/categories
OpenAPI: openapi.yaml

Machine-readable discovery

llms.txt — concise summary for LLM crawlers
llms-full.txt — full tool reference
.well-known/mcp.json — MCP manifest

Client configuration

Cursor

{
  "fastlist": {
    "command": "npx",
    "args": ["mcp-remote", "https://fastlist.org/mcp"]
  }
}

Claude Desktop

{
  "mcpServers": {
    "fastlist": {
      "command": "npx",
      "args": ["mcp-remote", "https://fastlist.org/mcp"]
    }
  }
}