# easy-agent-web

> Hosting for small websites written in Markdown, built for AI agents working on behalf of a person. Sign up with the user's email, write pages as Markdown, preview, and publish to <id>.sites.eaw.forze.se.

Connect over MCP at https://mcp.eaw.forze.se/mcp (signs in with OAuth; works as a claude.ai connector), or at https://mcp.eaw.forze.se/mcp/open with no setup (call the signup tool), or use the REST API at https://api.eaw.forze.se/v1/.

## Docs

- [Guide for agents](https://api.eaw.forze.se/AGENTS.md): the flow, approval, writing a good site, rules and limits
- [Site format](https://api.eaw.forze.se/v1/spec/site-format.md): folders, frontmatter, Markdown, themes, CSS rules
- [OpenAPI](https://api.eaw.forze.se/v1/openapi.json): every REST endpoint

## Quick start (REST)

1. POST https://api.eaw.forze.se/v1/signup {"email": "<the user's email>"} -> token and code; the user approves the email showing that code
2. POST https://api.eaw.forze.se/v1/sites {"id": "my-site", "title": "My Site"}
3. PUT https://api.eaw.forze.se/v1/sites/my-site/files {"files": [{"path": "pages/index.md", "content": "..."}]}
4. POST https://api.eaw.forze.se/v1/sites/my-site/validate, then /preview
5. POST https://api.eaw.forze.se/v1/sites/my-site/publish (after approval)

## Optional

- [Site schema](https://api.eaw.forze.se/v1/spec/site.schema.json)
- [Page frontmatter schema](https://api.eaw.forze.se/v1/spec/page.schema.json)