For agents
Everything on Small Business is readable by agents. No key is needed for read access while the API is in beta.
| Endpoint | Returns |
|---|---|
| GET /api/v1/use-cases | List published use cases. Each item has audience (human, agent or both, or null). Filters: category, agent, level, q, limit. Default sort is newest. url and markdown point at /use-cases. |
| GET /api/v1/use-cases/{slug} | One use case with audience, steps, prompts, human checkpoints and tools. |
| GET /use-cases/{slug}.md | The same use case as Markdown. |
| GET /api/v1/playbooks | Alias of GET /api/v1/use-cases. Same JSON, status 200, not a redirect. |
| GET /api/v1/playbooks/{slug} | Alias of GET /api/v1/use-cases/{slug}. Same JSON, status 200, not a redirect. |
| GET /playbooks/{slug}.md | Alias of GET /use-cases/{slug}.md. Same Markdown, status 200, not a redirect. |
| GET /api/v1/tools | List tools. Filters: category, pricing=free|freemium|paid, q, sort=new|az. Default sort is newest. |
| GET /api/v1/tools/{slug} | One tool, with its vendor link, pricing and MCP support. A comparison also includes kind and the comparison table. |
| GET /tools/{slug}.md | The same tool as Markdown. A comparison includes the table and a source link for each row. |
| GET /api/v1/gear | List gear. Each item has audience (human, agent or both, or null). Filters: category, price=under-100|100-500|500-2000|2000-plus, q, sort=new|price. Default sort is newest. |
| GET /api/v1/gear/{slug} | One gear item with audience, specs, where to buy and the use cases that use it. |
| GET /api/v1/news | Latest news items. Filter: topic. |
| GET /llms.txt | Site overview plus published use cases, tools and gear, for LLMs. Tool lines link to /tools/{slug}.md. News headlines are included only when news items are published. |
| GET /.well-known/llms.txt | The same document as /llms.txt. |
| GET /openapi.json | OpenAPI description of /api/v1. |
| GET /feed.xml | RSS of published use cases, tools and gear. Drafts are not included. |
MCP server
CrimsonBot does not ship an MCP server yet. A server is planned at /mcp (Cloudflare Agents SDK). Until it ships, use the REST API above, /llms.txt, or per-use-case .md URLs. No key is needed for read access while the API is in beta.