{"_id":"@cogniahq/mcp","name":"@cogniahq/mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@cogniahq/mcp","version":"0.1.0","description":"End-to-end encrypted memory for Claude Desktop, Cursor, Zed, and any MCP-compatible client. BYOK, hybrid search, and action execution against your Cognia workspace.","license":"MIT","author":{"name":"Cognia"},"homepage":"https://cogniahq.tech","repository":{"type":"git","url":"git+https://github.com/cogniahq/cognia-mcp.git"},"bugs":{"url":"https://github.com/cogniahq/cognia-mcp/issues"},"keywords":["mcp","model-context-protocol","cognia","claude","claude-desktop","cursor","zed","cline","e2ee","byok","memory","rag","ai"],"type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./client":{"types":"./dist/client.d.ts","import":"./dist/client.js"}},"bin":{"cognia-mcp":"dist/cli.js"},"scripts":{"build":"tsup src/index.ts src/cli.ts src/client.ts --format esm --dts --clean --sourcemap --target node18","dev":"tsx src/cli.ts","lint":"tsc --noEmit","prepublishOnly":"npm run build"},"engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^20.12.12","tsup":"^8.0.0","tsx":"^4.7.0","typescript":"^5.4.5"},"gitHead":"b7b4f4bb4ebcc39c2feada7bbc84366f37e0ec4a","_id":"@cogniahq/mcp@0.1.0","_nodeVersion":"22.20.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-YNd3kR216O34/YXfxbljdHnlvdLgVKky9zKcjR2qeD8oChcj9J58JdLfqk3vpaAoxPBcIFx4YmPu7MeLZMyN7Q==","shasum":"e78c498662448add385e6789280147eababc8d64","tarball":"https://registry.npmjs.org/@cogniahq/mcp/-/mcp-0.1.0.tgz","fileCount":20,"unpackedSize":73998,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHs2YDdebkw1tl2wqan3tP+dPhrqB1LXYNW9HHqFQKITAiEAzFnPS2CyvnQUjP+Yn2LUYLFctJwM6m+kfa4AQ933vN8="}]},"_npmUser":{"name":"virajbhartiya","email":"vlbhartiya@gmail.com"},"directories":{},"maintainers":[{"name":"virajbhartiya","email":"vlbhartiya@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.0_1780141832976_0.9096312670011455"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-30T11:50:32.763Z","0.1.0":"2026-05-30T11:50:33.136Z","modified":"2026-05-30T11:50:33.418Z"},"maintainers":[{"name":"virajbhartiya","email":"vlbhartiya@gmail.com"}],"description":"End-to-end encrypted memory for Claude Desktop, Cursor, Zed, and any MCP-compatible client. BYOK, hybrid search, and action execution against your Cognia workspace.","homepage":"https://cogniahq.tech","keywords":["mcp","model-context-protocol","cognia","claude","claude-desktop","cursor","zed","cline","e2ee","byok","memory","rag","ai"],"repository":{"type":"git","url":"git+https://github.com/cogniahq/cognia-mcp.git"},"author":{"name":"Cognia"},"bugs":{"url":"https://github.com/cogniahq/cognia-mcp/issues"},"license":"MIT","readme":"# @cogniahq/mcp\n\nEnd-to-end encrypted memory for Claude Desktop, Cursor, Zed, Cline, and any MCP-compatible client. Bring your own OpenAI key. Open source under MIT.\n\n```bash\nnpx -y @cogniahq/mcp init YOUR_COGNIA_API_KEY\n```\n\nThat prints the config block you paste into Claude Desktop, Cursor, or Zed. Restart the client and your AI assistant can query your Cognia workspace as a native tool.\n\n## What this is\n\nA Model Context Protocol server that exposes your Cognia memory to any MCP client. Your assistant can search, retrieve, and act against decisions, notes, documents, and integrations you've connected to Cognia (Slack, Notion, Linear, Jira, GitHub, Drive, and more).\n\nIt is the client-side surface. The backend it talks to is end-to-end encrypted at rest with per-org keypairs (libsodium Argon2id); the database holds only ciphertext. With BYOK enabled, your prompts and embeddings go to your OpenAI account on your contract, not ours. Threat model is public at <https://cogniahq.tech/security>.\n\n## Tools exposed\n\n| Tool | What it does |\n| --- | --- |\n| `cognia_search` | Hybrid (dense + sparse BM25) search with cross-encoder reranking |\n| `cognia_get_memory` | Fetch the full content of a single memory by id |\n| `cognia_list_memories` | Paginated chronological listing, optional substring filter |\n| `cognia_action_plan` | Draft an integration action (e.g. create a calendar event) |\n| `cognia_action_execute` | Execute a previously drafted action |\n\nMutating actions are drafted first by default. Execution is a separate tool call so the assistant cannot silently change your external systems.\n\n## Install\n\n### Claude Desktop\n\n```jsonc\n// ~/Library/Application Support/Claude/claude_desktop_config.json  (macOS)\n// %APPDATA%\\Claude\\claude_desktop_config.json                       (Windows)\n{\n  \"mcpServers\": {\n    \"cognia\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@cogniahq/mcp\"],\n      \"env\": { \"COGNIA_API_KEY\": \"ck_live_...\" }\n    }\n  }\n}\n```\n\n### Cursor\n\n```jsonc\n// ~/.cursor/mcp.json  (or .cursor/mcp.json in your repo for project-scoped)\n{\n  \"mcpServers\": {\n    \"cognia\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@cogniahq/mcp\"],\n      \"env\": { \"COGNIA_API_KEY\": \"ck_live_...\" }\n    }\n  }\n}\n```\n\n### Zed\n\n```jsonc\n// ~/.config/zed/settings.json\n{\n  \"context_servers\": {\n    \"cognia\": {\n      \"command\": { \"path\": \"npx\", \"args\": [\"-y\", \"@cogniahq/mcp\"] },\n      \"env\": { \"COGNIA_API_KEY\": \"ck_live_...\" }\n    }\n  }\n}\n```\n\nRestart your client. Your assistant now has Cognia tools.\n\n> Don't want to remember the JSON? Run `npx -y @cogniahq/mcp init` and it prints all three blocks with your API key inlined.\n\n## Getting an API key\n\n1. Sign up at <https://cogniahq.tech> (free up to 5 seats, no card)\n2. Open **Settings → API keys**\n3. Create a key. Copy the `ck_live_...` value (shown once)\n\n## Environment variables\n\n| Variable | Required | Default |\n| --- | --- | --- |\n| `COGNIA_API_KEY` | yes | — |\n| `COGNIA_BASE_URL` | no | `https://api.cogniahq.tech` |\n| `COGNIA_TIMEOUT_MS` | no | `30000` |\n\n## Use as a TypeScript client\n\nThe same package also exports a typed REST client if you want to build against the Cognia API without the MCP transport.\n\n```ts\nimport { CogniaClient } from '@cogniahq/mcp/client'\n\nconst cognia = new CogniaClient({ apiKey: process.env.COGNIA_API_KEY! })\n\nconst hits = await cognia.search.query({ query: 'postgres migration decision', limit: 5 })\nfor (const hit of hits) {\n  console.log(hit.title, hit.snippet)\n}\n```\n\nFull surface: `cognia.memories.list / iterate / retrieve / update / delete`, `cognia.search.query`, `cognia.actions.plan / retrieve / execute`. Built-in retry with exponential backoff and `Retry-After` support.\n\n## Build from source\n\n```bash\ngit clone https://github.com/cogniahq/cognia-mcp.git\ncd cognia-mcp\nnpm install\nnpm run build\nnode dist/cli.js --help\n```\n\n## Why open source\n\nIf you ship an MCP server that touches company knowledge, your security team will want to read it before approving the install. So we open-sourced ours. The encrypted backend, search pipeline, and admin console stay closed. The surface that runs on your machine is right here.\n\nThe integrations SDK and a small `cognia` memory CLI will follow on the same MIT terms.\n\n## License\n\nMIT. See [LICENSE](./LICENSE).\n\n## Links\n\n- Cognia: <https://cogniahq.tech>\n- API docs: <https://cogniahq.tech/developers>\n- Security and threat model: <https://cogniahq.tech/security>\n- Pricing: <https://cogniahq.tech/pricing>\n- Issues: <https://github.com/cogniahq/cognia-mcp/issues>\n","readmeFilename":"README.md","_rev":"1-c2359dc26eeabd54674d80f84e73dc9d"}