# Headcode CMS

> Headcode CMS is an open-source CMS for small and medium websites that should be editable by both people and agents.

## Summary

Headcode CMS provides structured website content, draft/live publishing, a simple admin UI, Markdown output, and MCP tools for authenticated AI clients. It is built around the idea that websites should be useful to humans and agents.

## Positioning

- Agentic Web CMS.
- Built for small and medium websites that need controlled editing after launch.
- Open source so owners and coding agents can inspect, fork, and customize the system.
- HTML for humans, Markdown and llms.txt for agents, MCP for authorized edits.
- Intended for sites with practical business information: offers, pricing, docs, locations, constraints, and next steps.

## Key Links

- [Homepage](/?md): Product overview, demo-site references, and CMS philosophy.
- [Documentation](/docs?md): Setup and usage documentation.
- [GitHub](https://github.com/headcodecms/headcodecms): Source code.

## Project Map

- Public site routes: app/(site)/
- Admin routes: app/(admin)/
- CMS config: headcode/config.ts
- Section definitions: headcode/sections.ts
- Default content: headcode/defaults.ts
- Convex services: convex/services.ts
- MCP route: app/(mcp)/[transport]/route.ts

## Editing

- [Admin](/admin): Human content editing UI protected by Convex Auth.
- [MCP](/mcp): Authenticated MCP endpoint for content updates.

Markdown helps agents understand the site. MCP lets authorized agents change it.