Synap MCP Server

synap-mcp-server

Hosted remote MCP server (Streamable HTTP) that re-fronts the existing Synap public REST operations as MCP tools, so no-code platforms (Gumloop, n8n) can give their agents persistent memory with nothing but a pasted MCP URL and a Bearer token.

It is a stateless adapter — no new backend, storage, or pipeline. Each tool call maps to one existing REST operation, and the incoming Bearer synap_<key> token is forwarded verbatim to synap-cloud, which owns auth.

• Public endpoint (prod): https://synap-mcp.maximem.ai/mcp
• Health: https://synap-mcp.maximem.ai/health

Tools

Tool	REST operation	Notes
log_exchange	POST /api/v1/memories/create (mode=long-range)	Forward every turn; extraction decides what persists. Optional user_id/customer_id scope per end-user; optional conversation_id.
recall_context	POST /v1/context/{client|user|customer}/fetch (mode=fast)	Hot path; no IDs ⇒ client scope. Optional user_id/customer_id.
list_recent_memories	broad /v1/context/.../fetch (no query)	Debug / "test my memory". Optional user_id/customer_id.

Scoping. Pass no IDs ⇒ client scope (shared per credential). Pass user_id (and/or customer_id) on both log_exchange and recall_context to keep each end-user's memory separate — fill these from an n8n expression / Gumloop input. Note: client-scope writes are not surfaced on the dashboard Memories page (relational), so per-user scoping is recommended when dashboard visibility matters.

Host header. The server disables the MCP transport's DNS-rebinding check (it sits behind a proxy + Bearer auth), so any reverse proxy can forward the real Host — no Host-rewrite hack needed.

Run locally

pip install -e ".[dev]"
SYNAP_API_URL=http://localhost:8000 uvicorn synap_mcp_server.server:app --port 8090
curl http://localhost:8090/health        # {"status":"ok",...}

Test

pip install -e ".[dev]"
pytest -q

Config (env)

Var	Default	Meaning
SYNAP_API_URL	http://synap-cloud:8000	Backing REST API base URL (internal docker hostname in prod).
MCP_PORT	8090	Listen port.
MCP_RECALL_TIMEOUT_S	10	Recall (read) timeout.
MCP_INGEST_TIMEOUT_S	8	Log/ingest (write) timeout.
MCP_DEFAULT_MAX_RESULTS	10	Default recall result count.
LOG_LEVEL	INFO	Log level.
ENVIRONMENT	production	Reported in /health.

No Synap API key is configured on the server — the end user's key arrives per-request as a Bearer token.

See the Synap documentation for platform setup guides (Gumloop, n8n) and deployment details.