{
  "markdown": "<!-- mcp-name: io.github.SynapseLayer/synapse-layer -->\n<div align=\"center\">\n\n# 🧠 Synapse Layer\n\n### RAG retrieves. Synapse remembers.\n\n**Persistent memory infrastructure for AI agents — AES-256-GCM encrypted at rest, semantic search, MCP-native.**\n\nSynapse Layer is open-source persistent memory infrastructure for AI agents and assistants. Memories are encrypted at rest with AES-256-GCM, indexed via pgvector HNSW for semantic recall, and exposed through MCP JSON-RPC for native integration with Claude, GPT, Gemini, and any MCP-compatible client. Apache 2.0 licensed.\n\n[![PyPI](https://img.shields.io/pypi/v/synapse-layer)](https://pypi.org/project/synapse-layer/)\n[![Python](https://img.shields.io/pypi/pyversions/synapse-layer)](https://pypi.org/project/synapse-layer/)\n[![Downloads](https://img.shields.io/pypi/dm/synapse-layer)](https://pypi.org/project/synapse-layer/)\n[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-6B4FBB)](https://modelcontextprotocol.io)\n[![Official MCP Registry](https://img.shields.io/badge/MCP_Registry-Published-00C853)](https://registry.modelcontextprotocol.io)\n[![CI](https://github.com/SynapseLayer/synapse-layer/actions/workflows/ci.yml/badge.svg)](https://github.com/SynapseLayer/synapse-layer/actions/workflows/ci.yml)\n[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)\n[![Smithery](https://img.shields.io/badge/Smithery-Add%20to%20MCP-800080?logo=smithery)](https://smithery.ai/servers/synapselayer/synapselayer)\n\n[Website](https://synapselayer.org) · [Docs](https://forge.synapselayer.org/docs) · [PyPI](https://pypi.org/project/synapse-layer/) · [Forge](https://forge.synapselayer.org)\n\n</div>\n\n---\n\n## ⚡ 30-Second Quickstart\n\n```bash\npip install synapse-layer\n```\n\n```python\nfrom synapse_layer import Synapse\n\ns = Synapse(token=\"sk_connect_YOUR_TOKEN\")\n\ns.store(\"user likes coffee\")\nprint(s.recall(\"what does user like?\"))\n```\n\nGet your token at [forge.synapselayer.org](https://forge.synapselayer.org) → Dashboard → Connect\n\n---\n\n## What is Synapse Layer?\n\nThe **persistent memory layer for AI agents** — the missing piece between stateless LLMs and real continuity of context.\n\nYour AI agents forget everything between sessions. Synapse Layer fixes that.\n\n| Feature | Description |\n|---------|-------------|\n| 🔐 **Encrypted at rest** | AES-256-GCM with per-operation random IV and HMAC-SHA-256 integrity |\n| 🧩 **One-click connect** | Claude Desktop, Cursor, LangChain, CrewAI, n8n |\n| 🌐 **Cross-agent memory** | Save in ChatGPT, recall in Claude |\n| ⚡ **MCP-native** | Any MCP-compatible agent |\n| 🔒 **Header-first auth** | Tokens never in URLs or logs |\n| 🎯 **Trust Quotient** | Deterministic recall — memories ranked by confidence, not recency alone |\n\n---\n\n## Why Synapse Layer?\n\n> Your AI agents forget everything between sessions. Synapse Layer fixes that — in one line.\n\n| Without Synapse Layer | With Synapse Layer |\n|---|---|\n| Agent forgets context every session | Persistent memory across all sessions |\n| Memory locked to one model | Cross-agent: save in ChatGPT, recall in Claude |\n| No audit trail | Trust Quotient scoring on every memory |\n| Complex integration | `pip install synapse-layer` + 3 lines of code |\n| Plaintext stored on servers | AES-256-GCM encrypted at rest |\n\n---\n\n## Use Cases\n\n- **Long-term assistant memory** — persist user preferences, facts, and prior decisions across sessions.\n- **Cross-agent continuity** — save context in one agent and recall it in another.\n- **Secure memory for MCP clients** — connect Claude Desktop, Cursor, and other MCP-compatible tools to a governed memory layer.\n- **Operational memory for teams** — maintain structured context, trust scoring, and searchable recall for production agents.\n\n---\n\n## Install\n\n```bash\npip install synapse-layer\n```\n\n## Quick Start\n\n### Python Script\n\n```python\nfrom synapse_layer import Synapse\n\nclient = Synapse(token=\"sk_connect_YOUR_TOKEN\")\n\n# Store\nclient.store(\"User prefers dark mode and concise answers\")\n\n# Recall\nresults = client.recall(\"user preferences\")\nfor r in results:\n    print(r[\"content\"], r[\"trust_quotient\"])\n```\n\n### With Context Manager\n\n```python\nfrom synapse_layer import Synapse\n\nwith Synapse(token=\"sk_connect_YOUR_TOKEN\") as client:\n    client.store(\"User prefers dark mode and concise answers\")\n    results = client.recall(\"user preferences\")\n    for r in results:\n        print(r[\"content\"])\n```\n\nGet your token at [forge.synapselayer.org](https://forge.synapselayer.org) → Dashboard → Connect\n\n---\n\n## 13 MCP Tools at a Glance\n\nSynapse Layer currently exposes 13 MCP tools for persistent memory workflows:\n\n- `recall`\n- `save_to_synapse`\n- `process_text`\n- `search`\n- `health_check`\n- `initialize_context`\n- `save_memory`\n- `store_memory`\n- `recall_memory`\n- `list_memories`\n- `memory_feedback`\n- `neural_handover`\n- `slo_report`\n\nThese tools cover memory capture, semantic recall, structured storage, feedback loops, agent handoff, and operational observability.\n\n---\n\n## Deployment Modes\n\n### Python Script Mode\nUse the SDK when you want direct Python access to Forge memory from your application.\n\nBest for:\n- prototypes and scripts\n- Python-native workflows\n- fast integration into existing apps\n\n### Cloud / Forge API\nUse Forge when you need persistent, cross-session, and cross-agent memory with managed access tokens.\n\nBest for:\n- production assistants\n- multi-agent systems\n- MCP-based integrations\n- shared memory across tools and sessions\n\n---\n\n## MCP Integration (Claude Desktop / Cursor)\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"synapse-layer\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"https://forge.synapselayer.org/api/mcp\",\n        \"--header\",\n        \"x-connect-token: sk_connect_YOUR_TOKEN\"\n      ]\n    }\n  }\n}\n```\n\nConfig file location:\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- Linux: `~/.config/Claude/claude_desktop_config.json`\n\n---\n\n## API — Header-First Auth\n\n```bash\n# Health check\ncurl -H \"x-connect-token: sk_connect_YOUR_TOKEN\" \\\n  https://forge.synapselayer.org/api/connect/health\n\n# Save memory\ncurl -X POST \\\n  -H \"x-connect-token: sk_connect_YOUR_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"content\": \"User is a Python developer\"}' \\\n  https://forge.synapselayer.org/api/v1/capture\n```\n\n---\n\n## Security\n\n| Feature | Implementation |\n|---------|---------------|\n| Encryption | AES-256-GCM at rest with per-operation random IV |\n| Integrity | HMAC-SHA-256 on content |\n| Auth | Header-first (`x-connect-token`) — tokens never in URLs or logs |\n| Privacy | Content sanitization + tenant-scoped encrypted storage |\n| Isolation | 1 user = 1 tenant = 1 private mind |\n\nSee [SECURITY.md](SECURITY.md) for vulnerability reporting.\n\n---\n\n## Related Projects\n\n| Project | Description |\n|---------|-------------|\n| [synapse-sdk-python](https://github.com/SynapseLayer/synapse-sdk-python) | Python SDK — LangChain, CrewAI, and A2A protocol adapters |\n| [synapse-layer-skill](https://github.com/SynapseLayer/synapse-layer-skill) | MCP skill configuration for Claude Desktop, Cursor, Windsurf |\n| [synapse-layer-langgraph](https://github.com/SynapseLayer/synapse-layer-langgraph) | LangGraph checkpoint saver with encrypted state persistence |\n\n---\n\n## Governance\n\n- All public claims follow the [Public Claims Matrix](docs/PUBLIC_CLAIMS_MATRIX.md).\n- Architecture details that reveal benefits are public; mechanisms that enable them are private.\n- Claim = Reality. If it's not implemented, it's not in the README.\n\n---\n\n## License\n\nApache-2.0 © Synapse Layer",
  "bytes": 7679,
  "sha": "4abf13dfa9977c6e03538c19d1ad289167f2654b218ffddaa958a24245e23617",
  "repo_slug": "synapselayer/synapse-layer",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_synapselayer_synapse_secure_me_d571f064/readme"
}