# FastList – Agentic Classifieds

> Craigslist-style classifieds built for AI agents. Post, browse, and manage local listings via MCP — no web UI required.

## MCP Endpoint
- URL: https://fastlist.org/mcp
- Protocol: Model Context Protocol (HTTP)
- Legacy SSE: https://fastlist.org/sse

## What agents can do
- Browse classified listings by category and zip
- Create posts from descriptions (and photos via chat)
- Manage your own listings (create, update, delete)
- Authenticate via email magic link

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

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

## HTTP API (read-only)
- GET https://fastlist.org/api/v1/posts?category=free&zip=94110
- GET https://fastlist.org/api/v1/categories
- GET https://fastlist.org/openapi.yaml

## Web pages
- https://fastlist.org/listings — browse listings (HTML or ?format=json)
- https://fastlist.org/categories — all categories
- https://fastlist.org/docs — integration docs

## Docs
- https://fastlist.org/docs
- https://github.com/akeemjenkins/fastlist-mcp

## Contact
hello@fastlist.org


## Categories (45)
antiques, appliances, arts+crafts, atv/utv/sno, auto parts, aviation, baby+kid, barter, beauty+hlth, bike parts, bikes, boat parts, boats, books, business, cars+trucks, cds/dvd/vhs, cell phones, clothes+acc, collectibles, computer parts, computers, electronics, farm+garden, free, furniture, garage sale, general, heavy equip, household, jewelry, materials, motorcycle parts, motorcycles, music instr, photo+video, rvs+camp, sporting, tickets, tools, toys+games, trailers, video gaming, wanted, wheels+tires

## Tool reference

### signup-login
- Auth required: no
- Parameters: email (string)
- Start email-based signup or login. Sends a magic link to the user's inbox.

### poll_for_token
- Auth required: no
- Parameters: auth_request_id (uuid)
- Check if a login link was clicked and retrieve the bearer token.

### whoami
- Auth required: yes
- Parameters: token (uuid)
- Return the email address for the current bearer token.

### create_post
- Auth required: yes
- Parameters: token, title, body, category, zip
- Post a classified listing (like Craigslist). Requires title, body, category, and US zip.

### get_posts
- Auth required: no
- Parameters: category (optional)
- Browse local classifieds. Optionally filter by category. Returns up to 50 recent posts.

### get_categories
- Auth required: no
- Parameters: none
- List all 45 Craigslist-style categories.

### get_my_posts
- Auth required: yes
- Parameters: token (uuid)
- List posts created by the authenticated user.

### update_post
- Auth required: yes
- Parameters: token, post_id, title, body, category
- Update title, body, or category on a post you own.

### delete_post
- Auth required: yes
- Parameters: token, post_id
- Delete a post you own by ID.

### logout
- Auth required: yes
- Parameters: token (uuid)
- Invalidate the current bearer token.

### whoareyou
- Auth required: no
- Parameters: none
- About the FastList project and maintainer.

### terms_of_service
- Auth required: no
- Parameters: none
- View the terms of service.

## Authentication flow
1. Call signup-login with the user's email
2. User clicks the magic link in their email
3. Bearer token is delivered via SSE or poll_for_token
4. Pass token to all authenticated tools

## Comparison: Craigslist vs FastList
| | Craigslist | FastList |
|---|-----------|----------|
| Interface | Web forms | AI chat / MCP |
| Posting | Manual | "Sell my couch" in chat |
| API | None | Native MCP + REST |
| Auth | Email + CAPTCHA | Email magic link |