{"data":{"name":"io.github.geml-spec/geml","title":"GEML — a plain-text document format built to be edited in place, one section at a time","description":"One section in, one section out — on Markdown/GEML files, bad writes refused.","version":"1.12.5","websiteUrl":"https://geml-spec.github.io/","repositoryUrl":"https://github.com/geml-spec/geml","remotes":[{"url":"https://geml-mcp.supermarket.workers.dev/mcp","type":"streamable-http"}],"packages":[{"version":"1.12.5","identifier":"@geml/geml","runtimeHint":"stdio","registryType":"npm","runtimeArguments":null,"environmentVariables":null}],"status":"active","isLatest":true,"publishedAt":"2026-10-09T00:28:05.647Z","updatedAt":"2026-10-09T00:28:05.647Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":"GEML — a plain-text document format built to be edited in place, one section at a time","source":"official-registry","sourceId":"io.github.geml-spec/geml","updatedAt":"2026-10-09T00:28:05.647Z","confidence":100,"websiteUrl":"https://geml-spec.github.io/","description":"One section in, one section out — on Markdown/GEML files, bad writes refused.","verification":"official","repositoryUrl":"https://github.com/geml-spec/geml"}],"toolIndex":{"tools":[{"serverName":"io.github.geml-spec/geml","endpointFingerprint":"d63fdfe82b669f8393618d4b49e0a92afbf5d2f2da89804f0ca96ffa7832c92e","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` 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`.","inputSchema":{"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"]},"annotations":{"title":"Insert new content","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"45cdfce4c6f661b9e52490a0de21faa38114e0d99d34e0ffb30486f8254cc52f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:04.084Z","metadataTrust":"untrusted"},{"serverName":"io.github.geml-spec/geml","endpointFingerprint":"d63fdfe82b669f8393618d4b49e0a92afbf5d2f2da89804f0ca96ffa7832c92e","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 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`.","inputSchema":{"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."}},"required":["source"]},"annotations":{"title":"Validate a document","readOnlyHint":true,"openWorldHint":false},"definitionHash":"72d124b06745438b1084d3ff75223a0c69fe53ca26ce112b3c8137d510831f8a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:04.084Z","metadataTrust":"untrusted"},{"serverName":"io.github.geml-spec/geml","endpointFingerprint":"d63fdfe82b669f8393618d4b49e0a92afbf5d2f2da89804f0ca96ffa7832c92e","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 pointing at a removed block come back as diagnostics but do NOT block the deletion — read them, then repair the references or revert. A selector that names nothing is skipped, so repeating a call changes nothing. 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`.","inputSchema":{"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."},"ids":{"type":"array","items":{"type":"string"},"description":"The blocks to remove: ids or addresses"}},"required":["source","ids"]},"annotations":{"title":"Delete blocks","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"definitionHash":"3f75f2dc148d8a741123708b7ab57ca2c0cbd0783e116220c829a637a677d632","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:04.084Z","metadataTrust":"untrusted"},{"serverName":"io.github.geml-spec/geml","endpointFingerprint":"d63fdfe82b669f8393618d4b49e0a92afbf5d2f2da89804f0ca96ffa7832c92e","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-insensitive unless `case` is true. No match is an empty result, not an error. 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`.","inputSchema":{"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."},"pattern":{"type":"string","description":"Text to look for inside block bodies"},"case":{"type":"boolean","description":"Match case exactly (default: case-insensitive)"},"head":{"type":"boolean","description":"Add the matching line as a third column"},"within":{"type":"string","description":"Optional: only look inside the blocks this selector names, e.g. `#install` for a section or `=== table` for every table. It takes the same selector forms as geml_get's `id`."}},"required":["source","pattern"]},"annotations":{"title":"Find the blocks that hold some text","readOnlyHint":true,"openWorldHint":false},"definitionHash":"220b3564390c4eb3bcbb9988dcfb24a085fec5cc6beb33d00b13d75c80a5b97e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:04.084Z","metadataTrust":"untrusted"},{"serverName":"io.github.geml-spec/geml","endpointFingerprint":"d63fdfe82b669f8393618d4b49e0a92afbf5d2f2da89804f0ca96ffa7832c92e","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: 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`.","inputSchema":{"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."},"id":{"type":"string","description":"What to read: a block id (with or without `#`), a `## Heading` line (its whole section), `=== type` for every block of a type, `=== code {lang=py}` or `{.warn}` for every block carrying those attributes, a `@<hex>` content address for a block with no id, or `L27`/`L27-58` for the smallest block holding those lines — the forms `geml_list` prints, plus the line numbers an editor or a diff hunk speaks"},"view":{"type":"boolean","description":"Read THROUGH an `embed` block to the entity block it stands for, following a multi-layer chain to its end. An `embed` has no content of its own, so this is the only way to see what it points at; on any other block it changes nothing. Returns {from, content}: `from` names the document the content actually came from, and its references and relative paths resolve against THAT document, not this one."},"part":{"type":"string","enum":["whole","head","intro","body"],"description":"How much of the block to return (default: whole). For a SECTION these cut it three ways: `head` is the heading line, `intro` everything under it up to its first subheading, `body` everything under it — so `body` always contains `intro`, and equals it when the section has no subheading. Reach for `intro` to read a section's opening without pulling its subsections into the conversation; a whole `#id` on a top-level heading is often the entire document. Only a heading has an intro. `body` is usually what you want together with `view`."},"within":{"type":"string","description":"Optional: only look inside the blocks this selector names, e.g. `#install` for a section or `=== table` for every table. It takes the same selector forms as geml_get's `id`."}},"required":["source","id"]},"annotations":{"title":"Read one block","readOnlyHint":true,"openWorldHint":false},"definitionHash":"de170690fa7eb0db69ad81c76caf6778137a551485ce3f39ae42cb839010d35c","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:04.084Z","metadataTrust":"untrusted"},{"serverName":"io.github.geml-spec/geml","endpointFingerprint":"d63fdfe82b669f8393618d4b49e0a92afbf5d2f2da89804f0ca96ffa7832c92e","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, so give such a block one first. A file that is not under the server root is an error. 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`.","inputSchema":{"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."},"within":{"type":"string","description":"Optional: only look inside the blocks this selector names, e.g. `#install` for a section or `=== table` for every table. It takes the same selector forms as geml_get's `id`."}},"required":["source"]},"annotations":{"title":"List the blocks of a document","readOnlyHint":true,"openWorldHint":false},"definitionHash":"dfb43df6bcfd78d92dad4b7b0c5cf0d8d222975a527dddb8d2776d34ff180218","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:04.084Z","metadataTrust":"untrusted"},{"serverName":"io.github.geml-spec/geml","endpointFingerprint":"d63fdfe82b669f8393618d4b49e0a92afbf5d2f2da89804f0ca96ffa7832c92e","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 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`.","inputSchema":{"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."},"old":{"type":"string","description":"Current id"},"new":{"type":"string","description":"New id"}},"required":["source","old","new"]},"annotations":{"title":"Rename a block id","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"bc32c60b6960d1394d9ec082081d6ed38a5a20d623054edf2321b40c52641f8b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:04.084Z","metadataTrust":"untrusted"},{"serverName":"io.github.geml-spec/geml","endpointFingerprint":"d63fdfe82b669f8393618d4b49e0a92afbf5d2f2da89804f0ca96ffa7832c92e","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 drops blocks, the write goes through and the result names each one, so check it after shortening a section; geml_revert puts one back. `part` replaces the whole block (default), its head line, a section's `intro`, or its body. In a Markdown file a heading's anchor is its text, as on GitHub: new heading text gives the heading a new address, and the document's links to the old one follow in the same write. GEML content written over a Markdown heading or prose is converted to Markdown, as in geml_add; a GEML block already in the file stays GEML. An `id` that matches no block, or several, 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`.","inputSchema":{"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."},"id":{"type":"string","description":"Which block to replace: an id (with or without `#`), a `@<hex>` content address from `geml_list` for a block with no id, or `L27`/`L27-58` for the smallest block holding those lines. Must match exactly one block"},"body":{"type":"string","description":"The replacement text"},"part":{"type":"string","enum":["whole","head","intro","body"],"description":"What to replace (default: whole). `intro` replaces a section's opening — everything under the heading up to its first subheading — and leaves every subsection byte-identical, which is what makes a read-edit-write cycle on a long section safe. An empty intro (a subheading follows the heading immediately) is written into, so this also adds an opening where there was none."}},"required":["source","id","body"]},"annotations":{"title":"Replace one block","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"definitionHash":"f4e58058388aefb928e3f08f9613a095dc527334ee8aa0b2c2a178c0e13f2bbe","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:04.084Z","metadataTrust":"untrusted"},{"serverName":"io.github.geml-spec/geml","endpointFingerprint":"d63fdfe82b669f8393618d4b49e0a92afbf5d2f2da89804f0ca96ffa7832c92e","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 geml_set to land it. `to: \"html\"` also works but returns a whole self-contained page, usually tens of kilobytes this server cannot save: prefer the CLI (`geml <file> --to html -o out.html`) unless you want the markup in the conversation. A document with errors returns its diagnostics instead of a conversion, and a file that is not under the server root is an error. 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`.","inputSchema":{"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."},"to":{"type":"string","enum":["json","md","geml","html"],"description":"Target format. Default is the CLI's: a GEML input becomes json, a Markdown input becomes geml. `html` is a whole page — large, and not writable from here."},"from":{"type":"string","enum":["geml","md","json"],"description":"Override the input format, which is otherwise inferred from the extension (.md -> md, .json -> json, else geml)."}},"required":["source"]},"annotations":{"title":"Convert a whole document","readOnlyHint":true,"openWorldHint":false},"definitionHash":"dbde138c7ceb8d05977d7d9646a522ce76b7f2e4dac2f5696b1c805434a26f53","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:04.084Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"d63fdfe82b669f8393618d4b49e0a92afbf5d2f2da89804f0ca96ffa7832c92e","protocol":"streamable-http","status":"indexed","toolCount":9,"observedAt":"2026-11-19T14:46:04.084Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"io.github.geml-spec/geml":{"url":"https://geml-mcp.supermarket.workers.dev/mcp"}}},"Cursor":{"mcpServers":{"io.github.geml-spec/geml":{"url":"https://geml-mcp.supermarket.workers.dev/mcp"}}},"VS Code":{"servers":{"io.github.geml-spec/geml":{"type":"http","url":"https://geml-mcp.supermarket.workers.dev/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://geml-mcp.supermarket.workers.dev/mcp"},{"protocol":"mcp","package":"@geml/geml","registryType":"npm","version":"1.12.5"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:io.github.geml-spec%2Fgeml","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/io.github.geml-spec%2Fgeml","name":"io.github.geml-spec/geml","description":"One section in, one section out — on Markdown/GEML files, bad writes refused.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://geml-mcp.supermarket.workers.dev/mcp"},{"protocol":"mcp","package":"@geml/geml","registryType":"npm","version":"1.12.5"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://geml-spec.github.io/","repositoryUrl":"https://github.com/geml-spec/geml","version":"1.12.5"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"io.github.geml-spec/geml","status":"online","lastCheckedAt":"2026-11-20T04:16:50.515Z","lastSuccessfulCheck":"2026-11-20T04:16:50.515Z","latencyMs":290,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T04:16:50.515Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T04:16:50.515Z"},"security":null,"timestamps":{"createdAt":"2026-10-09T00:28:05.647Z","updatedAt":"2026-10-09T00:28:05.647Z","observedAt":"2026-11-20T04:16:50.515Z"},"compatibility":{"serverVersion":"1.12.5","protocolVersions":[{"protocol":"mcp","version":null}]}}}}