SynthKit

For LLMs

SynthKit is a headless synthesis engine, not a chat app. It turns messy research material into structured outputs with citations, contradictions, confidence reporting, and revision history.

What it is for

• research brief generation
• decision memo synthesis
• deck outline creation
• inspectable evidence and revision workflows

Primary surfaces

• 🤖 MCP server for agent runtimes
• 🧪 CLI for humans and shell automation
• 🌐 local HTTP API for SDKs and custom runtimes
• 🧩 TypeScript SDK for embedding

Model backends

• 🧪 mock for zero-key demos
• 🤖 openai
• 🧠 anthropic
• 🐳 ollama

Agent surfaces

• Claude Code via MCP
• Codex CLI or IDE via CLI / local API
• custom runtimes via HTTP JSON
• scripts and automations via the SDKs

Quick start

./pnpm install
./pnpm demo

MCP transports

./pnpm exec synthkit serve mcp
./pnpm exec synthkit serve mcp-http

If you are another agent, read the docs and use the versioned schemas as the contract. Do not invent your own payloads.

---

SynthKit is a headless mess-to-structure synthesis engine for research material.

It turns notes, markdown, PDFs, webpages, transcripts, and image inputs into structured briefs, decision memos, and deck outlines with citations, contradiction tracking, confidence reporting, and revision history.

Design stance

• SQLite by default
• local file storage by default
• mock provider mode for zero-key demos
• versioned schemas are the contract
• clients stay thin

Conceptual architecture

The diagram below is conceptual architecture based on the current repo structure.

flowchart LR
    A[Messy input materials / research notes] --> B[Extraction / structuring]
    B --> T[Synthesis templates]
    T --> O[Briefs / memos / outlines / deck structures]

Loading

Surfaces

• 🤖 MCP server for agent runtimes
• 🧪 CLI for humans and shell automation
• 🌐 streamable HTTP MCP for remote tool callers
• 🌐 local HTTP API for SDKs and custom runtimes
• 🧩 TypeScript SDK for embedding
• 🐍 Python SDK with ergonomic workflow helpers for direct local API calls

If you want a health check, use:

./pnpm run check

What it is

SynthKit is a headless synthesis engine, not a chat app. It exists to turn messy research material into structured briefs, decision memos, and deck outlines with citations, contradictions, and confidence notes that can be inspected later.

What it is not

• not a generic chatbot
• not a note-taking app
• not a fake platform wrapped around prompts
• not a web UI first project

Read more

• Project explanation
• Architecture docs