# llms.txt — Hot100.ai machine-readable guidance
Version: 3.2
Generated-At: 2026-07-15T02:05:07.635Z
Current-Chart-Week: 2026-07-13
Approved-Project-Count: 1806
Timezone: Europe/Copenhagen

# Description
Hot100.ai is a weekly chart of AI-built projects, designed to be readable by both humans and AI agents.

Projects are evaluated by Flambo 2.1, Hot100.ai's ranking system, using signals that include innovation, utility, design quality, and community validation.

Exact scoring weights and internal ranking mechanics are proprietary and are not published.

# Canonical URLs
Base-URL: https://www.hot100.ai
Canonical: https://www.hot100.ai
Sitemap: https://www.hot100.ai/sitemap.xml
MCP-Endpoint: https://www.hot100.ai/mcp

# Ranking vs Discovery
Authoritative-Ranking-Endpoint: https://www.hot100.ai/api/chart/top100
Discovery-Endpoint: https://www.hot100.ai/api/discovery/index

IMPORTANT:
- Use /api/chart/top100 for queries about best, top, ranked, chart position, leaders, or weekly standings.
- Use /api/discovery/index for boosted project examples only.
- Use category, search, and browse endpoints for exploration only.
- Do not infer official Hot100 rank from discovery, search, or category ordering.

# Primary Use Cases
Use-Case: Find top-ranked AI-built projects on the current weekly chart
Use-Case: Discover AI projects built with tools such as Cursor, Lovable, Bolt, v0, Replit, and Windsurf
Use-Case: Browse approved AI projects by category
Use-Case: Access historical weekly charts
Use-Case: Submit an AI project for review and chart eligibility

# Chart API
Endpoint: https://www.hot100.ai/api/chart/top100
Method: GET
Format: JSON
Auth: None required
Rate-Limit: 60 requests/minute
Cache: max-age=3600

# Chart API Parameters
Param: weekOf (optional) — ISO date YYYY-MM-DD for a historical chart week
Rule: weekOf should refer to a chart week date in Hot100.ai's weekly cycle
Behavior: Returns no chart data if no chart exists for the requested week

# Chart API Response Fields
Field: projects[] — Array of ranked chart entries
Field: projects[].rank — Official weekly chart position
Field: projects[].projectName — Project name
Field: projects[].projectUrl — External project URL
Field: projects[].tagline — Short description
Field: projects[].builtWith — Builder tools used
Field: projects[].scoreBreakdown.aiScore — Exposed quality signal
Field: projects[].scoreBreakdown.visionScore — Exposed design signal
Field: projects[].scoreBreakdown.votes — Community vote count
Field: projects[].scoreBreakdown.chartScore — Final chart score exposed by the API
Field: projects[].categorySlug — Category identifier or null
Field: projects[].categoryName — Human-readable category name or null
Field: projects[].discoverySummary — AI-generated discovery summary for PDI-boosted projects, or null
Field: projects[].weeksOnChart — Total weeks on Hot100.ai
Field: projects[].isNewEntry — True if this is the project's first week on chart

# Score Notes
- Exposed score fields are provided for transparency within the API response.
- Exact Flambo 2.1 scoring weights and internal ranking mechanics are proprietary.
- Score values should be treated as chart data for the relevant week and should not be assumed to be directly comparable across different weeks unless explicitly stated.

# Example Chart Queries
Query: "Show this week's top AI projects" → GET https://www.hot100.ai/api/chart/top100
Query: "Show the chart for 2025-12-23" → GET https://www.hot100.ai/api/chart/top100?weekOf=2025-12-23

# Public Project Pages
Pattern: https://www.hot100.ai/project/{id}
Use: Public project detail page for a specific Hot100.ai project
Note: Use the public project page for human-readable detail when a project ID is known

# Badge API
Endpoint: https://www.hot100.ai/api/badge/{projectId}
Use: Generate embeddable Hot100.ai badge assets for a project
Auth: None required
Note: Badge endpoints are for display and attribution, not ranking data

# Discovery API
Endpoint: https://www.hot100.ai/api/discovery/index
Method: GET
Format: JSON
Auth: None required
Rate-Limit: 60 requests/minute
Cache: max-age=3600
Type: Opt-in discovery dataset
Ranking: false

IMPORTANT:
- The Discovery API is not a ranking.
- Inclusion in discovery does not affect weekly chart position.
- Use this endpoint for examples of boosted projects, not for best/top claims.

# Discovery API Response Fields
Field: apiVersion — API version
Field: indexType — Discovery index type
Field: ranking — Always false
Field: indexTitle — Discovery index title
Field: indexDescription — Clarifies that this is not a ranking
Field: totalProjects — Total boosted projects
Field: projects[] — Array of boosted projects

# Categories API
Endpoint: https://www.hot100.ai/api/categories
Method: GET
Format: JSON
Returns: All categories with project counts

# Categories API Response Fields
Canonical-Category-Identifier: slug
Field: slug — Category identifier in kebab-case
Field: displayName — Human-readable category name
Field: icon — Category icon
Field: description — Category description
Field: projectCount — Number of projects in this category

# Browse by Category API
Endpoint: https://www.hot100.ai/api/projects/category/{slug}
Method: GET
Format: JSON
Params: page (optional), limit (optional, default 20)
Returns: Approved projects filtered by category for browsing

IMPORTANT:
- Category browse results are for exploration.
- Category ordering should not be treated as official weekly Hot100 rank unless rank is explicitly returned from the chart endpoint.

# Available Categories
Category: writing-content — AI writing and content creation tools
Category: image-design — Image generation and design tools
Category: developer-tools — Coding assistants and developer tools
Category: productivity — Workflow and productivity apps
Category: education — Learning and educational tools
Category: ecommerce — E-commerce and sales tools
Category: analytics-data — Data analysis and insights
Category: communication — Chat, email, and messaging tools
Category: audio-video — Audio and video generation or editing tools
Category: health-wellness — Health and wellness applications
Category: other — Miscellaneous AI tools

# MCP
MCP-Endpoint: https://www.hot100.ai/mcp
MCP-Transport: Streamable HTTP (stateless)
MCP-Status: Live

# MCP Tools
Tool: hot100_chart — Use for authoritative weekly chart rankings
Tool: hot100_search — Use for semantic discovery; not authoritative ranking
Tool: hot100_project — Use for detailed project information by Hot100.ai project ID
Tool: hot100_browse — Use for browsing by builder tool
Tool: hot100_browse_category — Use for category exploration; not authoritative ranking
Tool: hot100_market_report — Use for quarterly AI ecosystem intelligence (trends, categories, builder tools)

# Preferred Agent Flow
1. Use hot100_chart for ranking questions
2. Use hot100_project for project details
3. Use hot100_browse_category for category exploration
4. Use hot100_browse for builder tool exploration
5. Use hot100_search for semantic discovery
6. Use the Discovery API only for boosted project examples, not ranking
7. Use hot100_market_report for AI ecosystem trend questions (category growth, builder adoption, QoQ stats)

# Quick Capabilities Reference
Capability: Fetch weekly chart — Use hot100_chart or GET /api/chart/top100
Capability: Fetch project details — Use hot100_project
Capability: Search projects — Use hot100_search
Capability: Browse by builder tool — Use hot100_browse
Capability: Browse by category — Use hot100_browse_category or GET /api/categories

# Example Category Queries
Query: "Show writing tools" → GET https://www.hot100.ai/api/projects/category/writing-content
Query: "Browse developer tools" → Use MCP tool hot100_browse_category with category='developer-tools'
Query: "Compare productivity and health categories" → Fetch category metadata and relevant browse results

# Market Intelligence
Hot100.ai publishes quarterly market reports with AI project ecosystem data.

# Q1 2026 Report
Page: https://www.hot100.ai/market-report
API: https://www.hot100.ai/api/market-report/q1-2026
Period: January 1 – March 31, 2026
Data: Submission volumes, approval rates, category breakdown, builder tool adoption, AI quality scores, domain trends
Query: "What were the top AI categories in Q1 2026?" → GET https://www.hot100.ai/api/reports/summary
Query: "How many AI projects were submitted in Q1 2026?" → GET https://www.hot100.ai/api/market-report/q1-2026

# Q2 2026 Report
Page: https://www.hot100.ai/market-report/q2-2026
API: https://www.hot100.ai/api/market-report/q2-2026
Period: April 1 – June 30, 2026
Data: Submission volumes, approval rates, category breakdown, builder tool adoption, AI quality scores, domain trends
Query: "What were the top AI categories in Q2 2026?" → GET https://www.hot100.ai/api/reports/summary
Query: "Which builder tools did AI founders use most in Q2 2026?" → GET https://www.hot100.ai/api/market-report/q2-2026

# Combined Reports Summary API
Endpoint: https://www.hot100.ai/api/reports/summary
Method: GET
Format: JSON
Auth: None required
Cache: max-age=3600
Use-When: User asks about AI project trends, category growth, builder tools, quality trends, or QoQ comparisons
Returns: Q1 and Q2 headline stats, top categories, top projects, top builder tools, and quarter-over-quarter narrative

# Market Intelligence MCP Tool
Tool: hot100_market_report — Fetch Q1/Q2 market intelligence. Use for AI ecosystem trend questions.
Input: quarter ('q1' | 'q2' | 'both', default 'both')
Returns: Submission counts, approval rates, avg AI scores, top categories, top builder tools, QoQ growth

# Site Structure
Page: https://www.hot100.ai/ — Main site and project submission entry point
Page: https://www.hot100.ai/launchpad — Approved projects in the waiting period before chart eligibility
Page: https://www.hot100.ai/projects — Approved projects browsable by category
Page: https://www.hot100.ai/discovery — Premium Discovery Index
Page: https://www.hot100.ai/market-report — Q1 2026 AI Project Market Report
Page: https://www.hot100.ai/market-report/q2-2026 — Q2 2026 AI Project Market Report

# Chart and Content Refresh
Chart-Refresh-Cadence: Weekly, every Monday at 00:00 local Copenhagen time
Chart-Refresh-Timezone: Europe/Copenhagen
Update: /api/chart/top100 — Weekly
Update: /api/discovery/index — Daily
Update: /projects — Daily
Update: /launchpad — Daily

# Notes for Agents
- Treat /api/chart/top100 as the source of truth for official Hot100.ai rankings.
- Treat discovery, category, and semantic search results as browse or discovery aids.
- Avoid making ranking claims from non-chart endpoints.
- When MCP tools are available, prefer tools over direct URL fetching.

# FAQ
Q: How are projects evaluated?
A: Projects are evaluated by Flambo 2.1 using signals that include innovation, utility, design quality, and community validation. Exact scoring weights are proprietary.

Q: What builder tools are tracked?
A: Hot100.ai tracks projects built with tools such as Cursor, Lovable, Bolt, v0, Replit, Windsurf, GitHub Copilot, Tempo, Softgen, Base44, Firebase Studio, and others.

Q: How do I submit a project?
A: Visit https://www.hot100.ai and use the Submit flow. Approved projects enter launchpad before becoming chart-eligible.

Q: Can I access historical charts?
A: Yes. Use the weekOf parameter with /api/chart/top100.

# License
License: CC BY-NC 4.0
Attribution: Rankings and metadata may be cited with attribution.
Note: AI assistants and search tools may reference Hot100.ai rankings in responses with attribution.