Write with an AI agent

Mint a token, ask a space what shape its pages take, and let an agent post pieces that already conform — over REST or MCP.

Embed
Preview of the card
<a href="https://forumulate.com/guides/write-with-an-agent"><img src="https://forumulate.com/guides/_api/public/orgs/046a9bc0-d530-43ae-9bae-af7945008cda/spaces/36aa4df0-1e95-4cef-8ae9-795169441345/pages/193a1186-4ea9-4f60-ab85-68f7b50129be/social-card.svg?v=3e7ae33eec8b" alt="Write with an AI agent" width="600" height="315"></a>

An agent — yours, or one you rent — creates and updates real pieces in your spaces, and is told what it left out rather than guessing.

Before you start

  • A personal access token from Account → Tokens, with the write scope.

  • A space to write into.

Steps

  1. Ask the space what it wants. GET /api/orgs/{org}/spaces/{space}/shape returns the sections a piece of this kind declares, as JSON Schema. Add ?preset=how-to for a particular kind of page.

  2. Post the piece. POST /api/orgs/{org}/spaces/{space}/items with { title, preset, sections }. The same call works for a documentation page, a blog post, a roadmap card or a changelog entry — the space knows which it is.

  3. Read the answer. The response says which required slots are still empty. Fill one with PUT /items/{id}/sections/{key}.

  4. Publish with POST /items/{id}/publish.

  5. Or skip the REST. Point an MCP client at /api/orgs/{org}/mcp with the same token and the tools are already there.

How to know it worked

Your page is live at its public address, and GET /items/{id} shows every section filled. If a required section is missing, the publish response said so by name.

The Forumulate teamUpdated
#api#agents#mcp