Documentation

Complete reference for Synapse Layer — persistent, encrypted memory infrastructure for AI agents. Privacy-first, MCP-native, secure-by-design.

First Memory in 3 Minutes

~3 min3 curls · zero deps · no SDK required

The fastest path to your first AI memory. Export your token, grant consent, store and recall — all via curl.

Preview — full auth & headers in the walkthrough$ curl -X POST forge.synapselayer.org/api/v1/memory/commit \
-H "x-connect-token: $TOKEN" -d '{"content": "..."}'

Quota & upgrade (Free 100)

Free = 100 active memories. The 101st write returns HTTP 402 {"code":"quota_exceeded","upgrade_url":"https://forge.synapselayer.org/billing/upgrade"}. Check usage via GET /api/v1/usage or GET /api/forge/usage (x-connect-token) → {"total":44,"limit":100,"remaining":56}.

Pro lifts the limit to 1,000 active memories — $19/month (USD) or R$ 95,00/mês (BRL, Brazil).

Anonymous Agent Onboarding

Provision a trial token programmatically — no login, no UI. Call POST /api/v1/agent-onboard to receive an sk_connect_temp_ token good for 50 calls / 72h.

curl -X POST https://forge.synapselayer.org/api/v1/agent-onboard

When the trial is exhausted, calls return HTTP 402 with upgrade_url pointing to /billing/upgrade.

Quick Start

1

Get your Key

Export your Connect Token as an environment variable.

2

Consent + Store

Grant consent and commit your first memory — two curls.

3

Recall

Semantic search across your memories — one curl.

Security Pipeline

AES-256-GCM encryption, PII detection, differential privacy.

Authentication

Connect Tokens, OAuth 2.0 + PKCE, tenant isolation.

Installation

pip install, npm install, Smithery, or direct MCP connection.

Available Documentation

Getting Started

Core Concepts

Architecture

Security

SDKs

MCP

Examples

Release Notes