mcp-engram v2.1.0 — structured output, merge upserts, MCP SDK 1.30

What's Changed

Protocol & SDK

• Fixed the prompts capability — the server now implements prompts/list (previously "Method not found"), and prompts/get returns a valid user role instead of the non-conformant system
• Migrated to the MCP SDK's high-level McpServer API with zod input validation on every tool
• Structured tool output — all 8 tools declare outputSchema and return structuredContent alongside the JSON text blocks
• Tool titles and behavior annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) on all tools
• MCP SDK bumped 1.26 → 1.30 (2026-07-28 spec line)

Storage

• Merge instead of overwrite on upserts — re-creating an existing node or edge now merges: provided fields win, absent fields (columns and properties-blob keys) are preserved. Sparse re-creates no longer silently discard data, and the write tools are accordingly annotated non-destructive
• add_sources reports how many DERIVED_FROM links it created

Project

• CI workflow (lint/test/build on pushes and PRs) and a ROADMAP

Full Changelog: v2.0.0...v2.1.0

mcp-engram v2.0.0 — SQLite-backed cognitive knowledge graph

---

What's new

MCP Engram is now a zero-infrastructure MCP server — install and run with a single command:

npx mcp-engram

Highlights

• SQLite backend — Replaced Neo4j with a single-file SQLite database. No external services, no Docker, works offline. Database lives at ~/.mcp-engram/knowledge.db.
• npm package — Installable via npx mcp-engram or npm install -g mcp-engram. No need to clone the repo.
• FTS5 full-text search — BM25-ranked search across all 15 node types
• 8 MCP tools — search_nodes, explore_context, create_nodes, create_relations, add_sources, get_temporal_sequence, create_reasoning_chain, get_reasoning_chain
• 15 cognitive node types — Entity, Event, Concept, Attribute, Proposition, Emotion, Thought, ScientificInsight, Law, Location, ReasoningChain, ReasoningStep, Agent, Source, EmotionalEvent

Claude Desktop integration

{
"mcpServers": {
"mcp-engram": {
"command": "npx",
"args": ["mcp-engram"]
}
}
}

Breaking changes

• Neo4j backend removed entirely
• Knowledge processor Python client removed (will be published as a separate package)
• Package renamed from mcp-neo4j to mcp-engram

Prerequisites

• Node.js 18+
• C/C++ toolchain for better-sqlite3 native compilation (Xcode CLI tools on Mac, build-essential on Linux, VS Build Tools on Windows)

---