# AI access to CodeHype

CodeHype (https://codehype.ai) is a public AI and SaaS product directory plus launch platform.

## What agents can discover

- Published AI tools, SaaS, agents, APIs, startups, and related products
- Categories, tags, taglines, and public product pages
- Launch boards, trending lists, and winners
- How to submit a product (https://codehype.ai/submit) and listing guidelines (https://codehype.ai/guidelines)

Agents cannot access private profiles beyond public founder names on listings, admin review queues, authentication secrets, unpaid/draft listings, or internal webhooks.

## Public resources

Text:
- https://codehype.ai/llms.txt
- https://codehype.ai/llms-full.txt
- https://codehype.ai/ai.txt (this file)

JSON:
- https://codehype.ai/api/ai — structured site index, stats, categories, trending/recent/featured
- https://codehype.ai/api/products/catalog — compact public catalog for search UIs
- https://codehype.ai/api/md/_catalog — catalog of public content URLs
- https://codehype.ai/.well-known/api-catalog — machine-readable API catalog
- https://codehype.ai/v1 — versioned public REST API (products, categories, launches, search, stats)
- https://codehype.ai/openapi.json — OpenAPI 3.1 for /v1
- https://codehype.ai/mcp — MCP JSON-RPC endpoint
- https://codehype.ai/.well-known/mcp.json — MCP discovery document
- https://codehype.ai/.well-known/mcp/server-card.json — MCP server card

HTML (canonical for humans):
- Products: https://codehype.ai/product/{slug}
- Categories: https://codehype.ai/category/{slug}
- Launches: https://codehype.ai/launches
- Search: https://codehype.ai/search?q=

## API access

All listed discovery endpoints are GET, unauthenticated, UTF-8, and cached.
The public REST API lives at https://codehype.ai/v1. Query params: q, category, scope (all|ai|saas), kind, sort (trending|newest|upvoted), featured, trending, page, limit (max 50).
Responses use a JSON envelope with data and pagination (page, limit, total, totalPages, hasMore) where lists are paged.
There is no public write API for listings. Submissions go through https://codehype.ai/submit.

## MCP access

Available. POST JSON-RPC 2.0 to https://codehype.ai/mcp (protocol 2025-03-26, streamable HTTP). No authentication.
Initialize with method "initialize", then "tools/list" and "tools/call".
Discovery: https://codehype.ai/.well-known/mcp.json
Server card: https://codehype.ai/.well-known/mcp/server-card.json
Rate limit: 40 requests/minute per client IP.

## Usage limits

- Cache responses (typical freshness: 2–5 minutes).
- REST API: 60 requests/minute per client IP. MCP: 40 requests/minute.
- Prefer JSON/text endpoints over crawling every HTML page.
- Do not hammer /api/products/inspect, enrich, or upload routes; they are for the submit form, not discovery.
- Attribution: link to the canonical CodeHype product URL when citing a listing.
- Stats snapshot: 22 products, 17 AI tools, 10 SaaS products, 9 categories.

Contact: business.codehype@gmail.com