Sparks

What it does

Sparks is a specialized runtime for personal-scale knowledge bases. It separates the mechanical work (parsing frontmatter, indexing, link graph traversal) from the semantic work (synthesis, categorization), allowing AI agents to maintain a structured wiki with raw sources and derived views.

Tools

• sparks_scan: Scans the vault for changes and updates the manifest.
• sparks_prepare_ingest: Reads the inbox and classifies entries for the agent to process.
• sparks_finalize_ingest: Archives the inbox and commits changes to git.
• sparks_query: Search the vault by title, alias, tag, type, or maturity.
• sparks_lint: Validates the mechanical integrity of the knowledge base.
• sparks_brief: Generates a summary of recent activity within the vault.
• sparks_describe: Returns the canonical runtime contract for the agent.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "sparks": {
      "command": "sparks",
      "args": ["serve"],
      "transport": "stdio"
    }
  }
}

Supported hosts

• Claude Desktop
• Claude Code
• Codex
• Gemini CLI