Repository avatar
AI Tools
v2.4.6
active

synapse-layer

io.github.SynapseLayer/synapse-layer

MCP-native Trust Infrastructure for AI Agents. Persistent encrypted memory with Trust Quotient.

Documentation

๐Ÿง  Synapse Layer

RAG retrieves. Synapse remembers.

Persistent memory infrastructure for AI agents โ€” AES-256-GCM encrypted at rest, semantic search, MCP-native.

Synapse 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.

Status and limits: see FEATURES.md โ€” the public contract for what is shipped, gated, experimental or roadmap.

PyPI Python Downloads MCP Compatible Official MCP Registry CI License: Apache-2.0

Website ยท Docs ยท PyPI ยท Forge


โšก 30-Second Quickstart

Get your Connect Token at forge.synapselayer.org โ†’ Connect, then add the MCP endpoint to your client:

claude mcp add --transport http synapse-layer \
  https://forge.synapselayer.org/api/mcp \
  --header "x-connect-token: sk_connect_YOUR_TOKEN"

For Claude Desktop, Cursor and other clients, use the npx mcp-remote block under MCP Integration. Smithery's proxy/CLI was retired on 31 Oct 2026; the direct endpoint above is canonical.

Or use the Python SDK:

from synapse_layer import Synapse

s = Synapse(token="sk_connect_YOUR_TOKEN")

s.store("user likes coffee")
print(s.recall("what does user like?"))

Get your token at forge.synapselayer.org โ†’ Dashboard โ†’ Connect


What is Synapse Layer?

The persistent memory layer for AI agents โ€” the missing piece between stateless LLMs and real continuity of context.

Your AI agents forget everything between sessions. Synapse Layer fixes that.

FeatureDescription
๐Ÿ” Encrypted at restAES-256-GCM with per-operation random IV and HMAC-SHA-256 integrity
๐Ÿงฉ One-click connectClaude Desktop, Cursor, LangChain, CrewAI, n8n
๐ŸŒ Cross-agent memorySave in ChatGPT, recall in Claude
โšก MCP-nativeAny MCP-compatible agent
๐Ÿ”’ Header-first authTokens never in URLs or logs
๐ŸŽฏ Trust QuotientTrust-weighted recall โ€” confidence, recency and usage combined with semantic relevance

Why Synapse Layer?

Your AI agents forget everything between sessions. Synapse Layer fixes that โ€” in one line.

Without Synapse LayerWith Synapse Layer
Agent forgets context every sessionPersistent memory across all sessions
Memory locked to one modelCross-agent: save in ChatGPT, recall in Claude
No audit trailAppend-only audit events for scope changes and curation decisions
Complex integrationpip install synapse-layer + 3 lines of code
Plaintext stored on serversAES-256-GCM encrypted at rest

Use Cases

  • Long-term assistant memory โ€” persist user preferences, facts, and prior decisions across sessions.
  • Cross-agent continuity โ€” save context in one agent and recall it in another.
  • Secure memory for MCP clients โ€” connect Claude Desktop, Cursor, and other MCP-compatible tools to a governed memory layer.
  • Operational memory for teams โ€” maintain structured context, trust scoring, and searchable recall for production agents.

Install

pip install synapse-layer

Quick Start

Python Script

from synapse_layer import Synapse

client = Synapse(token="sk_connect_YOUR_TOKEN")

# Store
client.store("User prefers dark mode and concise answers")

# Recall
results = client.recall("user preferences")
for r in results:
    print(r["content"], r["trust_quotient"])

With Context Manager

from synapse_layer import Synapse

with Synapse(token="sk_connect_YOUR_TOKEN") as client:
    client.store("User prefers dark mode and concise answers")
    results = client.recall("user preferences")
    for r in results:
        print(r["content"])

Get your token at forge.synapselayer.org โ†’ Dashboard โ†’ Connect


13 MCP Tool Names at a Glance

Synapse Layer registers 13 public tool names (10 operations plus 3 aliases) for persistent memory workflows:

  • recall
  • save_to_synapse
  • process_text
  • search
  • health_check
  • initialize_context
  • save_memory
  • store_memory
  • recall_memory
  • list_memories
  • memory_feedback
  • neural_handover
  • slo_report

save_memory, store_memory and save_to_synapse are aliases; recall and recall_memory are aliases. These tools cover memory capture, semantic recall, structured storage, feedback loops, agent handoff, and operational observability.


Deployment Modes

The public package runs the client and local engine. The hosted Forge adds corporate organizations, projects, memberships, curation policies and audit. See FEATURES.md for what is OSS, hosted, gated or roadmap.

Python Script Mode

Use the SDK when you want direct Python access to Forge memory from your application.

Best for:

  • prototypes and scripts
  • Python-native workflows
  • fast integration into existing apps

Cloud / Forge API

Use Forge when you need persistent, cross-session, and cross-agent memory with managed access tokens.

Best for:

  • production assistants
  • multi-agent systems
  • MCP-based integrations
  • shared memory across tools and sessions

MCP Integration (one tested path per client)

Claude Code (CLI)

claude mcp add --transport http synapse-layer \
  https://forge.synapselayer.org/api/mcp \
  --header "x-connect-token: sk_connect_YOUR_TOKEN"

The URL is a positional argument โ€” claude mcp add --transport http <name> <url> โ€” there is no --url flag.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "synapse-layer": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://forge.synapselayer.org/api/mcp",
        "--header",
        "x-connect-token: sk_connect_YOUR_TOKEN"
      ]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root (same JSON block as above).

Any MCP client

Any host that runs npx can use the mcp-remote block above unchanged โ€” it bridges local stdio to the remote endpoint.

Config file locations:

  • Claude Desktop โ€” macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Claude Desktop โ€” Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Claude Desktop โ€” Linux: ~/.config/Claude/claude_desktop_config.json

API โ€” Header-First Auth

# Health check
curl -H "x-connect-token: sk_connect_YOUR_TOKEN" \
  https://forge.synapselayer.org/api/connect/health

# Save memory
curl -X POST \
  -H "x-connect-token: sk_connect_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content": "User is a Python developer"}' \
  https://forge.synapselayer.org/api/v1/capture

Security

FeatureImplementation
EncryptionAES-256-GCM at rest with per-operation random IV
IntegrityHMAC-SHA-256 on content
AuthHeader-first (x-connect-token) โ€” tokens never in URLs or logs
PrivacyContent sanitization + tenant-scoped encrypted storage
IsolationPersonal: 1 user = 1 private mind. Corporate: organization โ†’ projects โ†’ memberships, with tenant-scoped queries

See SECURITY.md for vulnerability reporting.


Related Projects

ProjectDescription
synapse-sdk-pythonPython SDK โ€” LangChain, CrewAI, and A2A protocol adapters
synapse-layer-skillMCP skill configuration for Claude Desktop, Cursor, Windsurf
synapse-layer-langgraphLangGraph checkpoint saver with encrypted state persistence

Governance

  • Public features and limits follow FEATURES.md.
  • Internal governance follows the Public Claims Matrix.
  • Architecture details that reveal benefits are public; mechanisms that enable them are private.
  • Claim = Reality. If it's not implemented, it's not in the README.

License

Apache-2.0 ยฉ Synapse Layer

No installation packages available.