io.github.geml-spec/geml

up checked 2026-11-11T04:39:17.426Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

GEML — a plain-text document format built to be edited in place, one section at a time

Publisher-provided description

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

Summary by lookupd

Lets an agent list, read, search, validate, edit and convert sections of GEML or Markdown documents, refusing invalid writes.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http geml https://geml-mcp.supermarket.workers.dev/mcp

Claude Code, npm package (stdio)

claude mcp add geml -- npx -y @geml/geml

Codex, remote (streamable-http)

codex mcp add geml --url https://geml-mcp.supermarket.workers.dev/mcp

Codex, npm package (stdio)

codex mcp add geml -- npx -y @geml/geml

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "geml": {
      "url": "https://geml-mcp.supermarket.workers.dev/mcp"
    }
  }
}

Cursor, npm package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "geml": {
      "command": "npx",
      "args": [
        "-y",
        "@geml/geml"
      ]
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (9 tools)

Publisher-provided text

• geml_list 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 eve
• geml_find 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 —
• geml_get 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
• geml_check 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 vali
• geml_to 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,
• geml_set 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, g
• 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 co
• geml_delete 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
• geml_rename 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, whi

Details

• Version: 1.13.1
• Transports: streamable-http, stdio
• Uptime (7 days): 100%
• Median latency: 281 ms
• First indexed: 2026-11-01T09:30:33.078Z
• Last seen in registry: 2026-11-10T11:17:30.222Z
• Repository: https://github.com/geml-spec/geml
• Website: https://geml-spec.github.io/

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.geml-spec/geml.svg)](https://lookupd.com/servers/io.github.geml-spec/geml)

• 62071 servers
• Last crawl: 2026-11-11T16:39:06.253Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp