# Clave

Clave is a managed website platform. An agent builds the site and Clave
publishes it. The owner of the site asks the agent for what they want, and
the agent calls this platform over HTTP.

Every capability here is a JSON API first. The chat connector and the
browser app call the same services that the API calls, so nothing is
available to one surface alone.

## Who these pages are for

They are for the person or the agent that drives Clave.

- Read **Start here** to get an account, a token and a first site.
- Read **Concepts** to learn what a site, a draft and a deployment are.
- Read **Connect an agent** to attach Clave to a chat client or a terminal.
- Read **API reference** for each call, what it does and what it answers.

## What these pages are not

They are not the skill. `GET https://api.heyclave.party/v1/skill` serves the instructions an
agent follows while it builds a site: the stages, the order and the
commands. These pages say what a thing **is**. Where the two would say the
same thing, a page here links to the skill.

They are also not a manual for the browser app at https://app.heyclave.party. The app is
where a person signs in, gives an agent access, approves a draft and pays
for the account. These pages name those four moments and link to them.

## The shape of the platform

| Surface | Address | Who uses it |
|---|---|---|
| JSON API | `https://api.heyclave.party/v1` | an agent, with a token |
| Chat connector | `https://api.heyclave.party/mcp` | a chat client, with a grant |
| Browser app | https://app.heyclave.party | the owner, in a browser |
| The skill | `https://api.heyclave.party/v1/skill` | an agent, before it builds |

## Read these pages as markdown

Add `.md` to the address of any page. [llms.txt](/llms.txt) lists every
page with its markdown address.

---

## Where this page sits

This is one page of the Clave documentation.
Read it as a web page at https://docs.heyclave.party/.
Every page has a `.md` address, and https://docs.heyclave.party/llms.txt lists them all.

- Next: [Get an account](https://docs.heyclave.party/start/account.md)
- Index: [Overview](https://docs.heyclave.party/index.md)