GEML — a plain-text document format built to be edited in place, one section at a time
v1.12.5One section in, one section out — on Markdown/GEML files, bad writes refused.
Endpoint health
online- Last checked
- 11/20/2026, 4:16:50 AM
- Latency
- 290 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.geml-spec%2Fgeml
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.geml-spec/geml": {
"url": "https://geml-mcp.supermarket.workers.dev/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
9 shown · authentication unknown
Insert new content
geml_add
Insert new content — one or more blocks, or prose — at the end of the document (`position: append`) or before/after the block named by `anchor`. Use this for content that does not exist yet; to change a block that does, use geml_set. Ids inside the content are kept. In a `.md` file Markdown lands as written, and GEML content is converted to Markdown as `to: "md"` converts it, the result's `notes` saying so; content Markdown cannot hold, such as a view without its source, is refused. Like every write here it is validated first: a missing anchor, an id that clashes with an existing one, or content that would break the document is refused. Returns `{ok, file, diagnostics, revision}`, with `notes` when the write did something to say out loud (a block it dropped, an address it changed); a refusal is `ok: false` with a `hint`, and the file is unchanged. This server is STATELESS: the document travels in `source` and a write comes back as `document` for you to save; it holds no other documents, so a cross-document reference such as `[[other.geml#id]]` cannot be resolved here and is reported as `unresolvable-document`.
Schema valid · SHA-256 45cdfce4c6f6…
View input schema
{ "type": "object", "properties": { "source": { "type": "string", "description": "The document's full text. This server keeps no files: what you send is the document." }, "name": { "type": "string", "description": "The document's file name, e.g. notes/spec.geml or README.md — it decides whether the text is read as GEML or as Markdown (a `.md` name), and it is how the document is called in messages. Default: document.geml." }, "content": { "type": "string", "description": "The GEML fragment to insert" }, "position": { "type": "string", "enum": [ "append", "before", "after" ], "description": "Where to insert" }, "anchor": { "type": "string", "description": "The block the insertion is relative to — an id, or any address geml_list prints; it must name one block. Required for before/after" } }, "required": [ "source", "content", "position" ] }
Connections
streamable-http
https://geml-mcp.supermarket.workers.dev/mcp