# neat.link for agents

neat.link pages can be written and kept up to date by an AI agent. Everything
the editor does is available over MCP and an HTTP API.

## Connect over MCP

The server is `https://neat.link/mcp` (Streamable HTTP). Clients sign in with OAuth:
you approve the connection once in the browser.

- **Claude Code:** `claude mcp add --transport http neat https://neat.link/mcp`
- **Claude (web and desktop):** Settings → Connectors → Add custom connector → `https://neat.link/mcp`
- **ChatGPT:** Settings → Connectors → Create → MCP server URL `https://neat.link/mcp`
- **Codex:** `codex mcp add neat --url https://neat.link/mcp`
- **Cursor and others:** add an HTTP MCP server with the URL `https://neat.link/mcp`.

Tools: `whoami`, `list_sites`, `read_page`, `check_handle`, `create_site`,
`update_site`, `set_picture`, `remove_picture`, `delete_site`.

## Use the HTTP API

Make a token in [Settings](https://neat.link/app/settings) and send it as
`Authorization: Bearer <token>`. The guide is at [https://neat.link/api/v1](https://neat.link/api/v1).

## Read any page

Every published page is Markdown at its address plus `.md` (for example
`https://neat.link/borkasm.md`), or at its own address with `Accept: text/markdown`.
The list of pages is in [the sitemap](https://neat.link/sitemap.xml); an overview for
language models is at [https://neat.link/llms.txt](https://neat.link/llms.txt).

## Writing a good page

Keep it short and in the owner's voice. The title is their name or brand; the
headline is one line on what they do. Put contact details and profiles in
buttons, not in the text. New sites are drafts: show the owner before you
publish.
