Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kiwifs.com/llms.txt

Use this file to discover all available pages before exploring further.

KiwiFS includes a built-in MCP server that exposes your knowledge base to AI tools.

Start the MCP server

# In-process (reads files directly, no server needed)
kiwifs mcp --root ~/knowledge

# Proxy mode (connects to a running KiwiFS server)
kiwifs mcp --remote http://host:3333

# Streamable HTTP transport (instead of default stdio)
kiwifs mcp --root ~/knowledge --http --port 8181

Configure Claude Desktop / Cursor

Add to your MCP configuration:
{
  "mcpServers": {
    "kiwifs": {
      "command": "kiwifs",
      "args": ["mcp", "--root", "/path/to/knowledge"]
    }
  }
}

Available tools

ToolDescription
kiwi_readRead a file’s content (with optional wiki link resolution, metadata-only mode, ETag caching)
kiwi_writeWrite/update a file (creates git commit, supports provenance)
kiwi_searchFull-text search across all pages (BM25, pagination, path prefix filter)
kiwi_treeList directory structure (with optional permalinks and depth)
kiwi_query_metaQuery frontmatter metadata (AND/OR filters, sort, pagination)
kiwi_queryRun DQL queries (TABLE, LIST, COUNT, DISTINCT)
kiwi_view_refreshForce-regenerate a computed view file
kiwi_deleteDelete a file (git commit preserves history)
kiwi_renameAtomically move/rename a file (auto-rewrites wiki links)
kiwi_bulk_writeWrite multiple files in a single atomic commit
kiwi_aggregateGroup by field with count, avg, sum, min, max
kiwi_importImport from external sources (databases, files, SaaS)
kiwi_exportExport to JSONL/CSV with optional embeddings
kiwi_changesList files changed since a checkpoint (incremental sync)
kiwi_appendAtomically append content to a file (no read-modify-write race)
kiwi_search_semanticVector similarity search using embeddings
kiwi_backlinksList all pages that link to a given page via wiki links
kiwi_analyticsKnowledge health metrics (stale pages, orphans, broken links)
kiwi_memory_reportEpisodic memory coverage (merged-from references)
kiwi_contextGet schema, playbook, and index in one call (call this first)
kiwi_health_checkPer-page health diagnostics (word count, link count, issues)
kiwi_suggestionsFind semantically similar pages (filters already-linked pages)
kiwi_embeddingsGet raw embedding vectors for a page’s chunks
kiwi_graph_analyticsPageRank, orphans, and structural connectivity metrics
kiwi_velocityChange velocity — hot spots, cold spots, and burst detection
kiwi_evalBenchmark search quality against expected results

Resources

MCP resources provide read-only access to structured data:
Resource URIDescription
kiwi://schemaThe knowledge base schema (SCHEMA.md)
kiwi://file/{path}Content of a specific file
kiwi://tree/{path}Directory listing
Last modified on May 4, 2026