@multiplist/mcp-server 0.13.5

package/README.md

@@ -0,0 +1,131 @@
+# @multiplist/mcp-server
+
+**Your personal AI conversation vault and project brain.**
+
+Extract decisions, frameworks, and insights from your AI conversations — with full provenance. Every claim traces back to exactly what you said.
+
+[![npm version](https://img.shields.io/npm/v/@multiplist/mcp-server)](https://www.npmjs.com/package/@multiplist/mcp-server)
+
+## What Multiplist Does
+
+Your AI conversations are intellectual property. Multiplist treats them that way.
+
+Save any conversation, document, or transcript — the extraction engine identifies nine categories of structured meaning: Decisions, Frameworks, Golden Passages, Definitions, Exemplars, Actions, Questions, Offers, and Emergence patterns. Each traced to exact character positions in the original source.
+
+Claude and ChatGPT connect to the same vault via MCP — no more re-explaining context between platforms.
+
+## Install
+
+```bash
+npm install @multiplist/mcp-server
+```
+
+## Connect via MCP
+
+Multiplist works as an MCP server. Connect from Claude Desktop, Claude Code, or any MCP-compatible client.
+
+**18 curated tools** across 5 categories:
+
+| Category | Tools | What They Do |
+|----------|-------|-------------|
+| **Capture** | `create_source`, `update_source`, `delete_source` | Save conversations to your vault |
+| **Extraction** | `trigger_extraction`, `batch_extract`, `batch_status` | Extract 9 categories of meaning |
+| **Custom Skills** | `list_skills`, `get_skill`, `match_skills`, `create_skill` | Teach the system YOUR categories |
+| **Discovery** | `get_source`, `search_vault`, `search_sources`, `get_vault_summary`, `get_vault_gaps` | Search and browse your knowledge |
+| **Intelligence** | `request_brief`, `get_brief_status`, `annotate_source` | Research briefs across your vault |
+
+## Example Prompts
+
+- "Save this conversation to my vault"
+- "What have I decided about pricing?"
+- "Show me my Seed Doc"
+- "Research how my positioning has evolved"
+- "What frameworks have I developed?"
+
+## How It Works
+
+**Push** → Paste a transcript, upload a file, or connect Claude directly via MCP.
+
+**Extract** → Nine categories of structured meaning, automatic, with full provenance.
+
+**Compose** → Organize into containers and studios, or describe what you need and let the workspace build itself.
+
+## Key Differentiators
+
+- **Extraction, not storage** — Save a conversation → get back 9 categories of structured meaning
+- **Citations, not summaries** — Every seed traces to exact character positions. Anti-hallucination by design
+- **Custom extraction skills** — Teach the system YOUR categories. A coach creates "Client Breakthroughs"
+- **Cross-platform vault** — Claude and ChatGPT share one vault via MCP
+- **Chat-native first** — Designed to work inside your AI tools, not replace them
+
+## Links
+
+- **Website:** https://multiplist.ai
+- **Learn Center:** https://multiplist.ai/learn
+- **Docs:** https://multiplist.ai/docs
+- **MCP Connector:** https://multiplist.ai/mcp
+
+---
+
+## Architecture
+
+### Core Concepts
+
+| Term | What It Is |
+|------|-----------|
+| **Source** | An imported document — conversation transcript, article, voice memo |
+| **Seed** | An atomic unit of meaning extracted from a Source (decision, framework, golden passage, etc.) |
+| **Seed Doc** | A synthesis document showing all 9 categories extracted from a Source, with provenance |
+| **Container** | A project-level organizer (clients, products, initiatives) |
+| **Studio** | A configurable workspace with modular components — choose your layout |
+| **Vault** | The central knowledge store — all Sources and Seeds, searchable and filterable |
+| **Aero** | The AI intelligence layer — chat interface with vault awareness |
+
+### The Meaning Loop
+
+```
+PUSH (import) → EXTRACT (9 categories) → COMPOSE (workspace) → PRODUCE (deliverables)
+```
+
+### Nine Extraction Categories
+
+| Category | What It Captures |
+|----------|-----------------|
+| Decisions | Choices made, directions locked |
+| Frameworks | Mental models, systems, structures |
+| Golden Passages | Quotable insights, key formulations |
+| Definitions | Terms coined, concepts explained |
+| Exemplars | Quality examples, standards to replicate |
+| Actions | Tasks, next steps, follow-ups |
+| Questions | Open loops, unresolved items |
+| Offers | Actionable next steps, opportunities |
+| Emergence | Patterns forming across sources |
+
+### Design Principles
+
+- **Your keys, your compute** — BYO API keys. You own your data.
+- **Provenance is integrity** — Every seed traces to exact character positions in the original source.
+- **Open meaning** — Seeds are portable markdown. Download always works.
+- **Recursion compounds** — Knowledge gets richer across passes, not flatter.
+- **Chat-native first** — The product works inside your AI tools, not alongside them.
+
+### Tech Stack
+
+| Layer | Technology |
+|-------|-----------|
+| **Frontend** | React 18, TypeScript, Vite, Tailwind CSS, shadcn/ui |
+| **Backend** | Node.js, Express, TypeScript |
+| **Database** | PostgreSQL, Drizzle ORM |
+| **AI** | OpenAI + Anthropic (BYO API keys) |
+| **MCP** | Model Context Protocol server (18 tools) |
+| **Hosting** | Railway |
+
+---
+
+## License
+
+MIT
+
+---
+
+*"Recursion compounds. Summarization collapses. Provenance is integrity."*