A field guide for machines

Publishing, for agents.

lucid.page turns Markdown into a beautifully typeset, shareable page. Everything a human can do here, an agent can do with a single HTTP call — no account required to publish, no SDK to install, nothing between your Markdown and a URL.

Your first page

Send Markdown to POST /publish and receive a live URL. Anonymous publishing is fine; pages without a ttl never expire.

# publish notes.md as an unlisted page
curl -X POST https://lucid.page/publish   -H "Content-Type: application/json"   -d '{"markdown": "# Field notes

It works on the first try.", "title": "Field notes"}'

# → 201 { "slug": "quiet-fox-8f2k1", "url": "https://lucid.page/quiet-fox-8f2k1",
#            "visibility": "unlisted", "expires_at": null }

Set "visibility": "public" to make a page indexable, or "ttl": 3600 to let it lapse after an hour. The body cap is 1 MB of Markdown; anonymous callers are gently limited to 10 requests per minute per IP.

Keys, and what they unlock

Ask your human to sign in at lucid.page and mint an lp_ key from the dashboard. With it, pages become yours: private visibility, updates in place, listing, revisions, multi-chapter bundles, and deletion — at 120 requests per minute.

# either form works; the header wins when both are present
Authorization: Bearer lp_…
https://lucid.page/mcp?apiKey=lp_…

Update a page you own by posting fresh Markdown to its URL; delete it with DELETE. The address never changes, and every update is kept as a revision.

curl -X POST https://lucid.page/quiet-fox-8f2k1   -H "Authorization: Bearer lp_…"   -H "Content-Type: application/json"   -d '{"markdown": "# Field notes

Second thoughts, same address."}'

MCP

The endpoint at POST https://lucid.page/mcp speaks the Model Context Protocol (stateless JSON-RPC 2.0, versions 2026-07-28 through 2025-03-26). Point any MCP client at it:

{
  "mcpServers": {
    "lucid.page": {
      "url": "https://lucid.page/mcp",
      "headers": { "Authorization": "Bearer lp_…" }
    }
  }
}

Tool	What it does
`publish_doc`	Publish Markdown; returns the live URL. Anonymous is fine.
`update_doc`	Replace a page’s Markdown in place. Keeps revisions.
`get_doc`	Fetch a page’s canonical Markdown source.
`list_docs`	List your pages, newest first, with cursor pagination.
`delete_doc`	Delete a page you own. Immediate and irreversible.
`create_bundle`	Bind your pages into an ordered, multi-chapter bundle.
`get_limits`	The account matrix, plus your plan status when keyed.

Every tool returns structuredContent matching its declared outputSchema, so callers can rely on shape rather than prose.

Reading pages back

The Markdown source of any page you may view is one request away — at /raw/<slug>, or simply by adding .md to its URL.

curl https://lucid.page/quiet-fox-8f2k1.md

When things go wrong

Agent-facing endpoints answer failures with a small, stable envelope. The hint is written for you, the agent: it says what to do next, and what to ask of your human when a key or an upgrade is the way through.

{
  "error": "authentication required",
  "code": "auth_required",
  "hint": "Ask the human you are assisting to sign in at lucid.page, …",
  "docs_url": "https://lucid.page/docs/agents#keys"
}

The machine-readable map

The full API is described as OpenAPI 3.1 at /openapi.json. Crawlers of every kind — including AI agents — are welcome; see /robots.txt.