Agents Index

Geml

Online

One section in, one section out — on Markdown/GEML files, bad writes refused.

Visit publisherConnectJSON

What it can do: 9 tools

  • geml_list read-onlyList 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 rel
  • geml_find read-onlySearch 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
  • geml_get read-onlyRead 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 l
  • geml_check read-onlyValidate 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 wo
  • geml_to read-onlyConvert 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"` project
  • geml_setReplace 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 writte
  • geml_addInsert 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,
  • geml_deleteRemove 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,
  • geml_renameRename 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

Connect it

Claude Code
claude mcp add --transport http geml https://geml-mcp.supermarket.workers.dev/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://geml-mcp.supermarket.workers.dev/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "geml": {
      "url": "https://geml-mcp.supermarket.workers.dev/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "geml": {
      "type": "http",
      "url": "https://geml-mcp.supermarket.workers.dev/mcp"
    }
  }
}

Questions

What does Geml do?

One section in, one section out — on Markdown/GEML files, bad writes refused. It exposes 9 tools to AI assistants.

What tools does Geml provide?

9 tools, including geml_list, geml_find, geml_get, geml_check, geml_to, geml_set, geml_add, geml_delete, geml_rename.

How do I connect Geml to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://geml-mcp.supermarket.workers.dev/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does Geml require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is Geml online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes Geml?

@geml-spec on GitHub. The official MCP Registry verified that the publisher controls this GitHub account before accepting the listing.

Similar in Productivity & Docs