As a person, never more
An agent acts as the person whose token it holds: the same role, the same locks, the same checks and the site’s own rules. A token reads, or reads and drafts; it lasts 1 to 90 days.
AI and MCP in Markstage AI that drafts. People who publish.
Markstage works with AI in two ways today: an MCP server, so an agent such as Claude can read your site and draft changes, and suggestions in the editor for the words people find slow to write. You bring your own key, and nothing reaches the site until a person has read it.
Ships today
The MCP server
Claude, or any client of the Model Context Protocol, connects to your Markstage server with a token a person made for it.
Drafts, unless you allow more
It creates and changes drafts, and puts changes to live pages into a release that is not scheduled. It never deletes, moves or promotes anything, and by default a person reviews the release and puts it live.
Publishing only if you allow it
An owner or administrator may give an agent a publish token, with a plain warning. The site’s checks run first and a failed one stops it; then the publish rules and roles decide as they would for that person. Every such publish names the agent, and a token publishes at most 5 times an hour.
Lossless
It reads and writes an entry as its file’s text, so a change touches only what the agent changed. Locked and synced blocks are refused, naming the block.
Every write is a commit
A draft the agent saves is a git commit that names the agent and its token, so the history shows who did what.
Connect a local client
Make a token in Settings → Tokens (“New AI assistant token”), then keep it with the markstage mcp relay, which passes each message from a client that starts a command on to your server:
npx markstage mcp login https://cms.example.comA client that speaks HTTP itself uses the MCP address the token screen shows, with the token as a bearer header.
Ships today
AI suggestions in the editor
Each suggestion sits next to the value it is for. Accept, edit then accept, or dismiss: nothing changes until you accept, and ⌘S saves it like any change.
Writing help on a selection
Select words, then Improve with AI: rewrite, shorten, fix the spelling or change the tone. The change shows beside the words; accept, edit or reject it.
Alt text suggestions
Suggest on an image’s Alt line writes a description for you to accept, change or dismiss.
Search title and description
Suggest title and description in the SEO check, next to the result as Google shows it.
Link suggestions to your own pages
Suggest links with AI in Post settings picks pages of your site and the words to link, each checked on the server: the page is there, not linked yet, and the words are in the text. Add link or dismiss each.
Fixes for search problems
Suggest a fix under a problem the SEO check found: a title or description too long or short, a heading out of order, “click here” link words, missing alt text. The fix shows as a diff to accept, edit or reject.
Translation drafts
Draft translation under a region in Post settings, for a person to read and save.
A promotion summary
Summarize changes beside a promotion’s reason, in plain words, from what the plan changes.
- Bring your own key: the person who runs the server sets
MARKSTAGE_AI_KEYor a key file. Without one, everything else works and the editor says why suggestions are off. - Anthropic, any OpenAI-compatible endpoint (OpenAI, Azure, OpenRouter, Together, LM Studio) or Ollama on your own machine with no key. The model and the limits per minute and per day are set on the server.
- A suggestion writes no file and no commit. Accepting it goes through the editor’s normal save, with the same rights, locks and checks.
Coming
What’s next for AI
From the roadmap. Nothing here ships today; the badge says when it is planned.
AI translation of a whole site
Draft every page of a site in another language in one run, for people to review.
The whole roadmap · Coming in 0.5.0 and Planned mark what is being built and what comes later.
Free to self-host, AI included
The MCP server and the suggestions come with the Markstage server. There is no Markstage cloud and no AI plan to buy.