# codingcat.dev: Agent Guide

> Autonomous AI Agent Navigation & Capability Guide for CodingCat.dev.

This site welcomes AI agents, LLM researchers, and coding assistants. No authentication or API keys are required for read operations.

## Capabilities & Protocols
- **MCP Server Card**: [`https://codingcat.dev/.well-known/mcp/server-card.json`](https://codingcat.dev/.well-known/mcp/server-card.json)
- **MCP Streamable HTTP Endpoint**: `https://codingcat.dev/api/mcp`
- **JSON API (OpenAPI 3.1)**: [`https://codingcat.dev/openapi.json`](https://codingcat.dev/openapi.json)
- **API Catalog (RFC 9727)**: [`https://codingcat.dev/.well-known/api-catalog`](https://codingcat.dev/.well-known/api-catalog)
- **Agent Skills**: [`https://codingcat.dev/.well-known/agent-skills/index.json`](https://codingcat.dev/.well-known/agent-skills/index.json)
- **AI Resource Manifest (ARD)**: [`https://codingcat.dev/.well-known/ai-catalog.json`](https://codingcat.dev/.well-known/ai-catalog.json)
- **Agent Index**: [`https://codingcat.dev/.well-known/agents.json`](https://codingcat.dev/.well-known/agents.json)
- **WebMCP**: Imperative tool `search_content` registered on page load and declarative form attributes

## Content Contracts
- **Authentication**: [`https://codingcat.dev/auth.md`](https://codingcat.dev/auth.md)
- **Pricing**: [`https://codingcat.dev/pricing.md`](https://codingcat.dev/pricing.md)
- **LLM Summary**: [`https://codingcat.dev/llms.txt`](https://codingcat.dev/llms.txt)
- **LLM Full Index**: [`https://codingcat.dev/llms-full.txt`](https://codingcat.dev/llms-full.txt)

## How to Connect

### 1. Direct Search API
```http
GET https://codingcat.dev/api/search?q={query} HTTP/1.1
Accept: application/json
```

### 2. Streamable HTTP Model Context Protocol (MCP)
```http
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": "astro" }
  },
  "id": 1
}
```

### 3. Markdown Content Negotiation
Every URL on `codingcat.dev` serves clean, token-efficient Markdown:
- Add `.md` extension: `https://codingcat.dev/blog.md`
- Or send header: `Accept: text/markdown`

## Etiquette & Policies
- Identify your agent with a descriptive User-Agent.
- Content usage preferences: `train-ai=n, search=y`.
- All public read requests are free and do not require rate-limiting under normal usage.