{"openapi":"3.1.0","info":{"title":"Synapse Layer API","version":"2.4.6","description":"MCP-Native Trust Infrastructure for AI Agents. Persistent, encrypted memory with AES-256-GCM encryption, cross-agent handover, Trust Quotient scoring, and built-in governance. The Trust Layer for the Agentic Internet.","contact":{"name":"Synapse Layer","url":"https://synapselayer.org","email":"founder.synapselayer@proton.me"},"license":{"name":"Apache-2.0","url":"https://www.apache.org/licenses/LICENSE-2.0"},"x-category":"Trust Infrastructure for AI Agents","x-mcp-compatible":true,"x-agent-discovery":true,"x-trust-quotient":true,"x-llm-optimized":true},"servers":[{"url":"https://forge.synapselayer.org","description":"Production — MCP + REST API"},{"url":"https://synapselayer.org","description":"Marketing site — discovery/pages only"}],"paths":{"/.well-known/mcp/server-card.json":{"get":{"operationId":"get_mcp_server_card","summary":"MCP server card for agent discovery.","description":"Returns the MCP server card with tool definitions, auth requirements, and transport configuration. Used by MCP-compatible clients to discover and configure the Synapse Layer server.","x-agent-readable":true,"tags":["Discovery"],"responses":{"200":{"description":"MCP server card","content":{"application/json":{}}}}}},"/.well-known/trust.json":{"servers":[{"url":"https://synapselayer.org","description":"Marketing site — discovery/pages only"}],"get":{"operationId":"get_trust_manifest","summary":"Trust manifest for agent discovery.","description":"Machine-readable trust manifest. Returns security, compliance, and capability metadata.","x-agent-readable":true,"tags":["Discovery"],"responses":{"200":{"description":"Trust manifest JSON","content":{"application/json":{}}}}}},"/.well-known/pricing.json":{"servers":[{"url":"https://synapselayer.org","description":"Marketing site — discovery/pages only"}],"get":{"operationId":"get_pricing","summary":"Machine-readable pricing for agent checkout.","description":"Returns current plan pricing, features, and future billing capabilities.","x-agent-readable":true,"tags":["Discovery"],"responses":{"200":{"description":"Pricing JSON","content":{"application/json":{}}}}}},"/.well-known/mcp.json":{"servers":[{"url":"https://synapselayer.org","description":"Marketing site — discovery/pages only"}],"get":{"operationId":"get_mcp_manifest","summary":"MCP capability manifest.","description":"Returns MCP server metadata including tools count, transport options, and integration links.","x-agent-readable":true,"tags":["Discovery"],"responses":{"200":{"description":"MCP manifest JSON","content":{"application/json":{}}}}}}},"components":{"securitySchemes":{"connectToken":{"type":"apiKey","in":"header","name":"x-connect-token","description":"Connect token (sk_connect_xxx) sent in the x-connect-token header. Get your key at https://forge.synapselayer.org/dashboard/connect"}}},"tags":[{"name":"Discovery","description":"Agent discovery and metadata endpoints (served from marketing site)"}],"externalDocs":{"description":"Synapse Layer Documentation","url":"https://synapselayer.org/docs"},"x-mcp-tools":{"x-canonical-source":"https://forge.synapselayer.org/api/mcp (tools/list)","x-snapshot-date":"2026-08-31","x-regeneration":"Re-run tools/list on Forge and diff before trusting these schemas.","recall":{"description":"Retrieve memories by semantic query. A reason is required for the audit trail.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Semantic search query"},"reason":{"type":"string","description":"Why this recall is performed (audit trail)"},"limit":{"type":"number","default":5,"description":"Max results to return"}},"required":["query","reason"]}},"save_to_synapse":{"description":"Persist an encrypted memory to the Forge Vault (AES-256-GCM at rest).","inputSchema":{"type":"object","properties":{"content":{"type":"string","description":"Memory content to store"},"agent_id":{"type":"string","description":"Agent identifier for cross-agent traceability"},"project":{"type":"string","description":"Project namespace"},"type":{"type":"string","description":"Memory type (e.g. long_term, short_term)"},"importance":{"type":"number","minimum":0,"maximum":1,"description":"Importance score"},"tags":{"type":"array","items":{"type":"string"},"description":"Tags for categorization"}},"required":["content"]}},"process_text":{"description":"Extract and store salient memories from a block of unstructured text.","inputSchema":{"type":"object","properties":{"content":{"type":"string","description":"Raw text to process"},"agent_id":{"type":"string","description":"Agent identifier"}},"required":["content"]}},"search":{"description":"Keyword and semantic search across stored memories.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"limit":{"type":"number","default":10,"description":"Max results"}},"required":["query"]}},"health_check":{"description":"Return server health and connectivity status.","inputSchema":{"type":"object"}},"initialize_context":{"description":"Initialize an agent session context before memory operations.","inputSchema":{"type":"object","properties":{"agent_id":{"type":"string","description":"Agent identifier"},"project":{"type":"string","description":"Project namespace"}}}},"save_memory":{"description":"Alias of save_to_synapse for compatibility.","inputSchema":{"type":"object","properties":{"content":{"type":"string","description":"Memory content to store"},"agent_id":{"type":"string","description":"Agent identifier"}},"required":["content"]}},"store_memory":{"description":"Alias of save_to_synapse for compatibility.","inputSchema":{"type":"object","properties":{"content":{"type":"string","description":"Memory content to store"},"agent_id":{"type":"string","description":"Agent identifier"}},"required":["content"]}},"recall_memory":{"description":"Alias of recall for compatibility. A reason is required for the audit trail.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Semantic search query"},"reason":{"type":"string","description":"Why this recall is performed (audit trail)"},"limit":{"type":"number","default":5,"description":"Max results"}},"required":["query","reason"]}},"list_memories":{"description":"List stored memories for the authenticated agent/tenant.","inputSchema":{"type":"object","properties":{"limit":{"type":"number","default":50,"description":"Max memories to list"},"agent_id":{"type":"string","description":"Filter by agent identifier"}}}},"memory_feedback":{"description":"Submit feedback on a memory to adjust its Trust Quotient.","inputSchema":{"type":"object","properties":{"memory_id":{"type":"string","description":"Target memory identifier"},"feedback":{"type":"string","description":"Feedback signal (e.g. positive, negative)"}},"required":["memory_id","feedback"]}},"neural_handover":{"description":"Hand over shared context from one agent to another via the tenant memory channel.","inputSchema":{"type":"object","properties":{"from_agent":{"type":"string","description":"Source agent identifier"},"to_agent":{"type":"string","description":"Target agent identifier"},"context":{"type":"string","description":"Context payload to hand over"}},"required":["from_agent","to_agent"]}},"slo_report":{"description":"Return service-level objective metrics for the authenticated tenant.","inputSchema":{"type":"object"}}}}