Developer & Agent Documentation
APIs, Machine-Readable Manifests & Autonomous Agent Protocols
Overview
CodingCat.dev provides open, machine-readable interfaces designed for both human developers and autonomous AI coding agents. All public read APIs are free and do not require API keys or registration.
Discovery Manifests
| Standard | Endpoint | Description |
|---|---|---|
| RFC 9727 API Catalog | /.well-known/api-catalog | IANA linkset discovery for all public APIs |
| OpenAPI 3.1 | /openapi.json | Complete machine-readable OpenAPI schema |
| MCP Server Card | /.well-known/mcp/server-card.json | Model Context Protocol server capability card |
| ARD AI Catalog | /.well-known/ai-catalog.json | Agentic Resource Discovery manifest |
| Agent Skills | /.well-known/agent-skills/index.json | Cloudflare Agent Skills Discovery index |
| Auth.md | /auth.md | Agent registration & authentication contracts |
| Pricing.md | /pricing.md | Agent pricing and usage constraints |
| Agent Guide | /AGENTS.md | Root-level agent capability guide |
Search API
Perform keyword search across tutorials, blog posts, podcasts, authors, and sponsors:
GET https://codingcat.dev/api/search?q=astro HTTP/1.1
Accept: application/jsonStreamable Model Context Protocol (MCP)
Agents can invoke MCP tools over HTTP POST:
POST https://codingcat.dev/api/mcp HTTP/1.1
Content-Type: application/json
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "search_content",
"arguments": { "query": "typescript" }
},
"id": 1
}Markdown Content Negotiation
Any page on CodingCat.dev can be retrieved in clean Markdown by appending .md to the URL (e.g., /blog.md) or sending the HTTP header Accept: text/markdown.