# Margin

> Margin is a writing platform for teams. Anyone can sign in, pick a name, start a
> workspace for their team and invite the people who write. Readers comment on a whole post
> or on any passage, and clap. Claude can write and answer comments through Margin's tools.

Margin is open source and runs on Holm: https://github.com/holmhq/unofficial-apps/tree/main/margin

## Addresses on this server

- `/` Margin's front page, with example workspaces
- `/<workspace>` a workspace's home; `/<workspace>/latest`, `/<workspace>/tag/<topic>`
- `/<workspace>/@<handle>` a writer's page in that workspace; `/@<handle>` across Margin
- `/<workspace>/@<handle>/<post>` a post, or `/<workspace>/<post>` when the workspace writes
  as itself; `/@<handle>/<post>` redirects to the post
- `/<workspace>/feed.xml` and `/<workspace>/@<handle>/feed.xml` RSS; `/sitemap.xml`
- `/new` start a workspace; `/join/<code>` accept an invite; `/studio` write and manage

## Writing with Claude

Add `/_holm/mcp` on this server as a custom connector in Claude (Settings → Connectors) or
ChatGPT, or run `claude mcp add --transport http margin https://<this server>/_holm/mcp` in
Claude Code, then sign in. Anyone signed in can; each tool allows only what the person can
do in Studio. Start with `me_get`: it lists your names and your workspaces. Every other tool
takes a `workspace`. Posts are Markdown; drafts unless the person asks to publish.
Fence code with its language to have it highlighted; write maths in LaTeX, `$…$` inline
or `$$` lines around a display formula. Readers
can't tell a person's personas are the same person, so never say which names belong
together. Personas: `personas_create`, `personas_update`, `personas_delete`. Owners and
admins run a workspace with `workspace_get`, `workspace_update`, `themes_activate`,
`team_list`, `team_update` (roles, or remove), `invites_create` and `invites_revoke`. Photos
and drawings: `media_upload` takes an SVG drawing as text or a small photo as base64;
`media_link` returns a one-hour link the person opens to add photos and videos, or that you
send files to with `curl -F file=@photo.jpg <link>`. Put the Markdown each returns on a line
of its own; pages pick the right size of a photo themselves.

## Reading

Every page is plain HTML. Posts carry JSON-LD (`BlogPosting`), a canonical address and an
RSS feed per workspace and writer.