eigma-mcp
Every tool description, input schema and shared extraction rule from the Eigma MCP connector, plus a runnable example server. The text a model reads, not the service behind it.
What Eigma is
Eigma turns your conversations with an AI assistant into a personal wiki you actually remember.
An assistant can explain something well, and almost none of it survives you closing the tab. A week later you remember that you understood the thing, but not the thing itself, and what you do recall is often subtly wrong. Eigma saves the part worth keeping, files it under the right chapter, and asks you about it again before you forget.
Your knowledge as a map. Each page is a point of light, and its brightness shows how well you still remember it rather than how recently you opened it. Pages you have internalized stay bright; pages you are forgetting go dim.
Eigma connects over MCP, so it works inside the assistant you already use — ChatGPT, Claude, and coding agents like Claude Code and Codex. Your assistant does the thinking; Eigma keeps the result. The app is available in English, 中文 and Deutsch. → eigma.app
Connect it to your assistant
Setup takes about a minute, and you do it once per assistant.
Create your Eigma account first, at eigma.app. Partway through, you will be asked to sign in, and your pages will go to whichever account you sign in with.
https://my.eigma.app/api/mcp-chatgpt
- Settings → Plugins
- Turn on Developer mode. The option to add your own plugin does not appear until you do.
- Browse plugins → + to add one
- Name it
Eigmaand paste the address into the server URL field - Sign in with your Eigma account and approve the connection
https://my.eigma.app/api/mcp
Claude: Customize → Connectors → + → Add custom connector, paste the address, Add, then sign in.
⚠️ Then open a chat, click the + at the bottom left, choose Connectors, and switch Eigma on. Claude uses only the connectors that are switched on in that particular conversation. If Eigma looks connected but nothing happens, this is almost always why.
Claude Code:
claude mcp add --transport http --scope user eigma https://my.eigma.app/api/mcp
claude mcp login eigma
Codex:
codex mcp add eigma --url https://my.eigma.app/api/mcp
codex mcp login eigma
The login command opens a browser window so you can sign in and approve. Afterwards, run
claude mcp list (or /mcp in a chat) to confirm the connection: worth doing, because a failed
connection fails silently.
Then, in any chat: "organize this into Eigma". Your assistant turns the conversation into pages, files each page under the right chapter, attaches a few questions to it, and sends the result to your review inbox.
Screenshots and troubleshooting: eigma.app/docs.
Menu paths verified against the ChatGPT and Claude apps in September 2026.
What you can ask it to do
Eight tools, five of them read-only. The read-only tools are what make your wiki usable as context inside the chat you are already in, rather than as something you have to open separately.
| Say something like | What happens |
|---|---|
| "What do I have on transformers?" | Matches across scripts, using CJK bigrams, German compound splitting and each page's aliases, so a page filed in English stays findable in the language you ask in |
| "Use my notes on Kubernetes to answer this" | Reads the page and answers from it |
| "Check this page against real sources" | Re-reads it, tests the claims, proposes a rewrite with inline footnotes and a References section |
| "These two pages are about the same thing, merge them" | Merges the two: the absorbed page's body is appended to the page you keep. Useful against the near-duplicates a growing wiki accumulates |
| "Go through my Cloud chapter and tell me what is badly organised" | Reads the chapter, then proposes all the moves and renames as a single changeset you can review in one pass |
| "These questions are weak, write better ones" | Adds, replaces or removes specific quiz questions |
| "What should I review today?" | Lists the pages you are closest to forgetting, rather than the ones you opened most recently |
| "Translate my page on embeddings into German" | Sends a translated copy to your inbox; the original page is untouched |
Everything that changes the wiki arrives as a reviewable changeset: a list of operations you approve or drop one by one. An assistant deciding that a change is a good idea is never enough to apply it.
What is in this repository
This repository holds everything a model reads when it talks to Eigma: the tool descriptions and the input schemas. The connector itself is a hosted MCP server with OAuth, and that part is not here.
Take what is useful: vendor src/rules.ts and compose your own descriptions from it, copy the
ingestSchema.ts pattern, or fork example/server.ts as a starting point.
npm install
npm test
npm run example # boots the example server and prints its address
src/toolSpec.ts | Descriptions for the six read tools (browse, search, read a page, resolve drafts, read memory state, translate), plus the outline and search helpers behind them. |
src/writeSpec.ts | Descriptions for the two write tools, each in a full and a slim variant. These are the tools that change your wiki, so their wording matters most. |
src/rules.ts | The 20 shared extraction rules that every tool description and the server instructions are composed from. Change a rule here and the change takes effect in every channel at once. |
src/ingestSchema.ts | The save tool's input schema. |
src/changeOpsSchema.ts | The edit tool's operation vocabulary, typed. |
src/skill.ts | The connector's skill and its server instructions: when to act, what order to call tools in, how not to loop. |
src/renderSurface.ts | A way to drive your own handler and get back the exact bytes tools/list puts on the wire. |
src/tools.ts | The ordered tool registry: reads before writes, plus the per-host type that decides which variant of each description is used. |
src/textNormalize.ts | The single text normalizer that every cross-language comparison in this repository uses. |
skill/eigma-filing/ | The generated Skill package, for hosts that load skills. Rebuild with npm run build:skill. |
example/server.ts | A working MCP server over a Map. No database, no auth, ~330 lines; six of the eight tools wired end to end. |
License
MIT © Eigma. The Eigma name, logo and screenshots are not covered by the MIT grant.