# 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