{"id":"io.github.geml-spec/geml","slug":"io-github-geml-spec-geml","title":"Geml","description":"One section in, one section out — on Markdown/GEML files, bad writes refused.","version":"1.13.1","publisher":{"kind":"github","id":"geml-spec","label":"@geml-spec on GitHub","url":"https://github.com/geml-spec"},"website":"https://geml-spec.github.io/","repository":"https://github.com/geml-spec/geml","remotes":[{"type":"streamable-http","url":"https://geml-mcp.supermarket.workers.dev/mcp"}],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"@geml/geml","version":"1.13.1","transport":{"type":"stdio"},"packageArguments":[{"type":"positional","value":"mcp"},{"description":"The one directory the server may read and write. Paths outside it are refused, including via ../, absolute paths, and symlinks. Use an absolute path: a relative one resolves against whatever working directory the client happens to start the server in.","isRequired":true,"type":"named","name":"--root","valueHint":"docs_directory"},{"description":"Optional code-graph directory inside --root, adding four read-only call-graph tools. Defaults to <root>/.geml/codemap when that holds an index.geml; with no graph those tools are not served.","type":"named","name":"--graph","valueHint":"code_graph_directory"}]}],"published":"2026-11-10","updated":"2026-11-10","status":"online","auth":"","latency_ms":1218,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"geml_list","title":"List the blocks of a document","description":"List every addressable block in a GEML document — its address, kind and heading text — in one call, with no paging. Call this FIRST: what it returns is what every other tool here addresses, and it is cheaper and more reliable than reading the file to see what is in it. Rows marked `anon` have no `#id`; geml_get and geml_set take their `address` as `id`, while the other write tools need a real id, ","read_only":true},{"name":"geml_find","title":"Find the blocks that hold some text","description":"Search block CONTENT in the document; each hit is one `<name>\\t<address>` row. geml_list says what a document contains, this says which block holds the words — as an address that pastes straight into geml_get or geml_set, not a line number the next edit invalidates. The address is the innermost block holding the match, and a block matching on many lines is reported once. Substring, case-insensitiv","read_only":true},{"name":"geml_get","title":"Read one block","description":"Read ONE block from a GEML document instead of the whole file: only that block comes back, typically a few percent of the document. Pass the `address` geml_list prints as `id` — it also reaches blocks with no `#id`; to locate a block by its words instead, use geml_find first. An `id` that matches nothing, or a file that is not under the server root, is an error naming it. This server is STATELESS:","read_only":true},{"name":"geml_check","title":"Validate a document","description":"Validate a GEML document without changing it: returns every diagnostic with a stable `code`, a severity and a line, and an empty list means the document is valid. Use it to confirm a document is sound before reporting work as finished. Every write through this server runs the same check before it lands, so a refused write already carries this information. This server is STATELESS: the document tra","read_only":true},{"name":"geml_to","title":"Convert a whole document","description":"Convert a WHOLE document and get the result back as text — the read half of the CLI's `geml <file> --to <fmt>`. `to: \"geml\"` on a Markdown file is the importer, the one thing the block tools cannot do; `to: \"md\"` projects a GEML document out (lossy); `to: \"json\"` returns the full document model, for when geml_list plus geml_get is not enough. Nothing is written — pass the result to geml_add or gem","read_only":true},{"name":"geml_set","title":"Replace one block","description":"Replace ONE block and leave every other byte untouched — prefer this to rewriting a file. For content that does not exist yet use geml_add; to remove a block, geml_delete. The replacement is validated before it is written: if it would break the document, nothing is written and the diagnostics come back — fix the body rather than resending it. Removing content is not refused: if the replacement dro","read_only":false},{"name":"geml_add","title":"Insert new content","description":"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` ","read_only":false},{"name":"geml_delete","title":"Delete blocks","description":"Remove one or more blocks, each named by an id or any address geml_list prints; a filter (`=== type`, `{key=value}`) removes every block it matches. Each block takes the blank line that separated it from its neighbours, so deleting what geml_add inserted leaves the file as it was. To undo a deletion, geml_revert the removed id; to change a block rather than remove it, use geml_set. References left","read_only":false},{"name":"geml_rename","title":"Rename a block id","description":"Rename a block id AND every reference to it in the same document, in one id-boundary-safe write. Use this rather than geml_set or a text search-and-replace, which would also hit ids that merely share a prefix. A Markdown heading's anchor is its text, so it is renamed by changing the heading with geml_set (`part: head`), not here. An `old` id that does not exist, or a `new` one already taken, is re","read_only":false}],"server_info":{"name":"geml","version":"1.12.5"},"category":"productivity","tags":[],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-07-28","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-geml-spec-geml/"}