{
  "markdown": "# Engram\n\n**Memory infrastructure for AI agents.** Store every conversation verbatim. Search by meaning.\n\n[![Website](https://img.shields.io/badge/website-getengram.app-blue)](https://getengram.app)\n[![Docs](https://img.shields.io/badge/docs-getengram.app%2Fdocs-blue)](https://getengram.app/docs/getting-started)\n[![License](https://img.shields.io/badge/license-BSL--1.1-green)](LICENSE)\n\nEngram is an MCP-native memory server that stores complete, uncompressed conversation transcripts and makes them searchable via semantic search. Connect any MCP-compatible client — Claude Desktop, Claude Code, Cursor, Windsurf, Zed — and your agent remembers everything across sessions.\n\n## Quick start\n\n### Claude Code\n\n```\n/plugin marketplace add get-engram/engram\n/plugin install engram@engram\n```\n\nRestart Claude Code and approve access in the browser. There is no API key to\ncopy and no config file to edit — the server implements the MCP authorization\nflow (RFC 9728 / 8414 / 7591, PKCE), so the client discovers it, registers\nitself, and signs you in. A free account is created as part of signing in.\n\nThe plugin also ships a skill that tells Claude when to search memory and what\nis worth saving, so context accumulates without being asked.\n\n### Any other MCP client\n\nPoint it at the remote server and let OAuth handle access:\n\n```json\n{\n  \"mcpServers\": {\n    \"engram\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.getengram.app/mcp\"\n    }\n  }\n}\n```\n\nFor a client that only speaks stdio, bridge to the remote server with\n[mcp-remote](https://www.npmjs.com/package/mcp-remote) — it drives the same\nbrowser OAuth flow, so there is still no key to copy:\n\n```json\n{\n  \"mcpServers\": {\n    \"engram\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.getengram.app/mcp\"]\n    }\n  }\n}\n```\n\n(An older version of this README suggested `npx @getengram/cli mcp`; the CLI\nhas no such command and that configuration never worked.)\n\n## How it works\n\n- **Verbatim storage** — every message stored exactly as sent, no summarization or compression\n- **Semantic search** — find relevant context by meaning using bge-base-en-v1.5 embeddings\n- **MCP-native** — speaks the Model Context Protocol natively, works with any compatible client\n- **Multi-tenant** — per-organization isolation, team seats, and API key management\n\n## Architecture\n\nRuns entirely on Cloudflare's developer platform:\n\n- **Workers** — Hono.js API and MCP server\n- **D1** — SQLite at the edge for messages and metadata\n- **Vectorize** — semantic search index\n- **Workers AI** — embedding generation\n\nRead the full [architecture deep-dive](https://getengram.app/docs/architecture).\n\n## MCP tools\n\nEngram exposes 6 tools via MCP:\n\n| Tool | Description |\n|------|-------------|\n| `create_conversation` | Start a new conversation with optional title, tags, metadata |\n| `append_messages` | Add messages to an existing conversation |\n| `search` | Semantic search across all conversations |\n| `get_conversation` | Retrieve a conversation with its messages |\n| `list_conversations` | List conversations with filtering and pagination |\n| `delete_conversation` | Remove a conversation and its data |\n\nSee the [API reference](https://getengram.app/docs/api-reference) for full parameters and examples.\n\n## Packages\n\n| Package | Description |\n|---------|-------------|\n| [`apps/mcp-server`](apps/mcp-server) | Cloudflare Worker — MCP server and REST API |\n| [`apps/cli`](apps/cli) | CLI and MCP bridge (`@getengram/cli`) |\n| [`packages/sdk`](packages/sdk) | TypeScript SDK (`@getengram/sdk`) |\n| [`packages/db`](packages/db) | Database queries and migrations |\n| [`packages/shared`](packages/shared) | Shared constants, types, and utilities |\n\n## Integration guides\n\n- [Claude Desktop](https://getengram.app/docs/guides/claude-desktop)\n- [Claude Code](https://getengram.app/docs/guides/claude-code)\n- [Cursor](https://getengram.app/docs/guides/cursor)\n- [Windsurf](https://getengram.app/docs/guides/windsurf)\n- [OpenAI Codex CLI](https://getengram.app/docs/guides/codex)\n- [Custom agents](https://getengram.app/docs/guides/custom-agents)\n\n## Pricing\n\n| Plan | Price | Messages/month |\n|------|-------|----------------|\n| Free | $0 | 1,000 |\n| Pro | $9/mo | 100,000 |\n| Team | $27/seat/mo | 500,000 |\n| Enterprise | Custom | Unlimited |\n\n[View pricing](https://getengram.app/pricing)\n\n## Links\n\n- **Website**: [getengram.app](https://getengram.app)\n- **Documentation**: [getengram.app/docs](https://getengram.app/docs/getting-started)\n- **Blog**: [getengram.app/blog](https://getengram.app/blog)\n- **npm**: [@getengram/cli](https://www.npmjs.com/package/@getengram/cli)\n\n## License\n\nBusiness Source License 1.1 — see [LICENSE](LICENSE) for details.\n",
  "bytes": 4713,
  "sha": "7305f27e63eb94f80b51b40783bd884eed666aa228987704d028929a5b9bac4c",
  "repo_slug": "get-engram/engram",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_app_getengram_engram_b561721d/readme"
}