# TopTenFast — Full AI Context

> TopTenFast is a community-driven platform for creating, sharing, and voting on ranked top-ten lists across hundreds of categories.

## About

TopTenFast lets anyone create ranked lists on any topic — from "Best Sci-Fi Movies" to "Top 10 Anime of All Time." Users vote items up or down to collectively determine rankings, add new items to existing lists, and discuss entries in threaded comments. The platform has 700+ lists spanning entertainment, technology, food, lifestyle, and more.

## Categories

- **Anime** — Lists about anime series, movies, characters, and recommendations (https://toptenfast.com/category/anime)
- **Movie** — Best movies by genre, year, director, and more (https://toptenfast.com/category/movie)
- **Music** — Top artists, albums, songs, and genres (https://toptenfast.com/category/music)
- **TV** — Television shows, dramas, streaming series (https://toptenfast.com/category/tv)
- **Game** — Video games, board games, gaming hardware (https://toptenfast.com/category/game)
- **Food** — Restaurants, recipes, cuisines, snacks (https://toptenfast.com/category/food)
- **Tech** — Software, gadgets, developer tools, electronics (https://toptenfast.com/category/tech)
- **Lifestyle** — Sports, fitness, hobbies, money, travel (https://toptenfast.com/category/lifestyle)
- **Other** — Everything else (https://toptenfast.com/category/other)

## Sample Lists

- Top 10 Martial Arts Movies of 2026 → https://toptenfast.com/list/top-10-martial-arts-movies-of-2026
- Top Ten Movies To Watch in 2026 → https://toptenfast.com/list/top-ten-movies-to-watch-in-2026
- Top Ten Wuxia Drama of 2026 → https://toptenfast.com/list/top-ten-wuxia-drama-of-2026
- Top Ten TV Shows of 2026 → https://toptenfast.com/list/top-ten-tv-shows-of-2026
- Top 10 Cultivation Donghua → https://toptenfast.com/list/top-10-cultivation-donghua
- Good anime recommendations? → https://toptenfast.com/list/good-anime-recommendations
- Should I use React or Angular? → https://toptenfast.com/list/should-i-use-react-or-angular

## Content Structure

Each **list** contains up to 10 ranked **items**. Items have:
- A title and optional description
- An optional image or YouTube video embed
- A community-driven score based on upvotes and downvotes
- A threaded comment section for discussion

## URL Patterns

- Homepage: https://toptenfast.com/
- Category page: https://toptenfast.com/category/{category-slug}
- List page: https://toptenfast.com/list/{list-slug}
- Item page: https://toptenfast.com/list/{list-slug}/{item-slug}
- Search: https://toptenfast.com/search?q={query}
- User profile: https://toptenfast.com/profile/{username}

## API (Read-Only)

TopTenFast provides a free, open, read-only JSON API for programmatic access:

- Base URL: https://api.toptenfast.com/api
- No authentication required

### Endpoints

- `GET /api/categories` — List all categories
- `GET /api/lists?category={slug}&limit=20&offset=0&sort=top` — Browse lists (sort: top, new, hot)
- `GET /api/list/{slug}` — Get a list with ranked items
- `GET /api/search?q={query}&limit=20` — Search lists and items
- `GET /api` — API documentation

## MCP Server (Model Context Protocol)

TopTenFast provides an MCP server for AI agents that support the Model Context Protocol:

- URL: `https://api.toptenfast.com/mcp`
- Protocol: MCP Streamable HTTP
- No authentication required

### Available Tools

- `list_categories` — Get all categories with list counts
- `browse_lists` — Browse lists with optional category filter, sorting (top/new/hot), and pagination
- `get_list` — Get a specific list with all ranked items, scores, and details
- `search_lists` — Search for lists and items by keyword

## Machine-Readable Resources

- OpenAPI Spec: https://api.toptenfast.com/api/openapi.json
- Sitemap: https://toptenfast.com/sitemap.xml
- Sitemap Index: https://toptenfast.com/sitemap_index.xml
- Summary: https://toptenfast.com/llms.txt