MCP server
Geneziz ships a local MCP (Model Context Protocol) server with 33 tools and 4 knowledge:// resources that lets Claude Code, Cursor, Windsurf, ZCode, and any MCP client search, read, and file your knowledge base.
What it is
Geneziz ships an MCP (Model Context Protocol) server that exposes your knowledge base to AI assistants. It is a local stdio server: it runs on your machine as a subprocess of your AI client, there is no port to configure, and it reads your local Markdown files directly. Your knowledge base does not leave your machine.
The server exposes 33 tools plus 4 knowledge:// resources (stats, index, trends, categories):
| Group | Tools |
|---|---|
| Search | search_knowledge (semantic), search_fulltext (keyword), find_related, find_duplicates, get_recent |
| Listings | list_tools, list_articles, list_tags, list_categories, list_domains |
| Read one item | get_tool, get_article, get_bookmark, get_stats |
| Ask + memory loop | ask_kb, list_conversations, get_conversation, append_conversation_turn |
| Write | save_url, add_note, summarize |
| Self-improvement | detect_gaps (read-only quality scan), fill_gaps (repair gaps; deterministic fills free, ai=True uses credits), build_wiki (Related (auto) sections + INDEX.md, idempotent), check_url (dedup pre-check), enrich_link (OG preview for saved stubs) |
| Resources | knowledge://stats, knowledge://index, knowledge://trends, knowledge://categories |
ask_kb answers a question over your whole knowledge base with cited sources, and a conversation_id threads follow-ups into a saved conversation. Asking costs 1 credit per question through the Geneziz Cloud proxy; it is free with your own API key (BYOK). See AI modes.
Activation
MCP requires an activated Geneziz account (the $99 one-time license) and runs locally on your machine. Registration - writing the config entries below - needs no license; starting the server does.
Automatic setup
geneziz mcp register
The command detects supported AI clients on your machine and writes the server entry into each one's config file: Claude Desktop, Claude Code, Cursor, Windsurf, Codex, VS Code, ZCode, and OpenCode. Each entry gets the absolute path to your geneziz executable, the mcp argument, and a GENEZIZ_DATA_DIR environment variable pointing at your data directory - so no PATH setup is needed. Only the geneziz entry is written; your other MCP servers stay untouched, and a one-time backup of each config is made before the first change.
Inspect or undo the registration:
geneziz mcp register --status # what's registered, per client (JSON)
geneziz mcp register --remove --all # remove only the Geneziz entries
Manual setup
Every client below takes the same server definition - command geneziz, argument mcp - shaped for that client's config file. The geneziz executable must be on your PATH (the automatic registration instead writes the absolute path, which removes that requirement).
Claude Code
Add a geneziz entry under mcpServers in ~/.claude.json:
{
"mcpServers": {
"geneziz": {
"command": "geneziz",
"args": ["mcp"]
}
}
}
Cursor
Add the same entry under mcpServers in ~/.cursor/mcp.json:
{
"mcpServers": {
"geneziz": {
"command": "geneziz",
"args": ["mcp"]
}
}
}
Windsurf
Add the same entry under mcpServers in ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"geneziz": {
"command": "geneziz",
"args": ["mcp"]
}
}
}
ZCode
ZCode reads a nested mcp.servers shape and requires "type": "stdio". Add a geneziz entry in ~/.zcode/cli/config.json:
{
"mcp": {
"servers": {
"geneziz": {
"type": "stdio",
"command": "geneziz",
"args": ["mcp"]
}
}
}
}
Environment pin
If your AI client launches geneziz mcp and finds an empty knowledge base, add the GENEZIZ_DATA_DIR environment variable to the entry, pointing at your data directory (for example ~/Library/Application Support/Geneziz on macOS). The automatic registration always writes this pin - see the vault.
Trying it
In a new session, ask a question that touches your saves:
What tools have I bookmarked for Rust async?
The assistant searches your local knowledge base and answers with titles, categories, and snippets. See Setting up the Geneziz MCP server with Claude Code for a walkthrough, and the overview for the rest of the product. Pricing is on /landing#pricing.