Skip to content

Commit 02bab8a

Browse files
committed
feat: smithery.yaml exposes all 13 MCP tools with clean descriptions
- Expanded from 5 to 13 tools (match Forge live server) - All descriptions clean: zero PII/Trust Quotient/zero-knowledge terms - Added configSchema with connect_token (required) + agent_id - Added full inputSchema for all tools including enums and required fields - Tools: 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
1 parent 426277e commit 02bab8a

1 file changed

Lines changed: 184 additions & 14 deletions

File tree

smithery.yaml

Lines changed: 184 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -26,77 +26,247 @@ configSchema:
2626
properties:
2727
connect_token:
2828
type: "string"
29+
title: "Synapse Connect Token"
2930
description: "Your Synapse Connect Token. Get it at synapselayer.org → Dashboard → Connect."
3031
agent_id:
3132
type: "string"
33+
title: "Agent ID"
3234
description: "Identifier for the agent using the memory layer. Defaults to 'default'."
3335
default: "default"
3436

3537
tools:
3638
- name: recall
37-
description: "Retrieves relevant past context and decisions to maintain continuity across interactions."
39+
description: "Retrieves relevant past context and decisions. Supports routing modes (auto/temporal/semantic/priority/hybrid)."
3840
inputSchema:
3941
type: object
40-
required: [query]
42+
required: [query, reason]
4143
properties:
4244
query:
4345
type: string
44-
description: "What to recall from memory"
46+
description: "What to recall — natural language query for memory retrieval."
47+
reason:
48+
type: string
49+
description: "Human-readable justification for the recall request (10–200 chars)."
50+
scope:
51+
type: string
52+
description: "Memory scope. 'agent' (default) limits to current agent, 'tenant' searches across all agents."
53+
enum: [agent, tenant]
4554
agent_id:
4655
type: string
47-
description: "Agent identifier to scope recall. Defaults to 'default'."
56+
description: "Agent identifier for scoped recall. Defaults to 'default'."
4857
limit:
4958
type: number
50-
description: "Maximum memories to return (1-50, default: 10)"
59+
description: "Maximum memories to return (1–50, default: 10)."
60+
mode:
61+
type: string
62+
description: "Recall routing mode."
63+
enum: [auto, temporal, semantic, priority, hybrid]
5164

5265
- name: save_to_synapse
53-
description: "Stores structured memory securely using AES-256-GCM encryption at rest."
66+
description: "Stores structured memory securely using AES-256-GCM encryption at rest with sanitization and deduplication."
5467
inputSchema:
5568
type: object
5669
required: [content]
5770
properties:
5871
content:
5972
type: string
60-
description: "Content to persist in encrypted memory"
73+
description: "The memory content to store securely."
6174
agent_id:
6275
type: string
63-
description: "Agent identifier. Defaults to 'default'."
76+
description: "Agent identifier for memory isolation. Defaults to 'default'."
77+
project:
78+
type: string
79+
description: "Project identifier (e.g., SYNAPSE_LAYER)."
80+
type:
81+
type: string
82+
description: "Event type: MILESTONE, DECISION, ALERT, AUTO-STRAT, AUTO-OP, AUTO-INSIGHT."
83+
importance:
84+
type: number
85+
description: "Importance level 1–5 (default: 3)."
86+
tags:
87+
type: array
88+
description: "Tags for categorization."
89+
items:
90+
type: string
6491

6592
- name: process_text
66-
description: "Extracts and persists structured memory from text input to maintain long-term context."
93+
description: "Extracts and persists structured memory from free-form text. Detects milestones, decisions, and alerts."
6794
inputSchema:
6895
type: object
6996
required: [text]
7097
properties:
7198
text:
7299
type: string
73-
description: "Text to process and extract memories from"
100+
description: "Free-form text to scan for auto-save triggers."
74101
agent_id:
75102
type: string
76103
description: "Agent identifier. Defaults to 'default'."
104+
project:
105+
type: string
106+
description: "Project identifier. Auto-detected if omitted."
107+
source:
108+
type: string
109+
description: "Source identifier (default: mcp)."
77110

78111
- name: search
79-
description: "Searches across stored memory using semantic retrieval. Returns results ranked by relevance and confidence."
112+
description: "Cross-agent memory search with full-text and semantic matching. Supports scope filtering."
80113
inputSchema:
81114
type: object
82115
required: [query]
83116
properties:
84117
query:
85118
type: string
86-
description: "Search query — natural language or keywords"
119+
description: "Search query — natural language or keywords."
120+
scope:
121+
type: string
122+
description: "Search scope. 'agent' (default) or 'tenant' for cross-agent search."
123+
enum: [agent, tenant]
87124
agent_id:
88125
type: string
89-
description: "Optional agent filter. Omit to search across all agents."
126+
description: "Agent identifier for scoped search."
90127
limit:
91128
type: number
92-
description: "Maximum results to return (1-50, default: 20)"
129+
description: "Maximum results to return (150, default: 20)."
93130

94131
- name: health_check
95132
description: "Verify system availability and memory pipeline integrity."
96133
inputSchema:
97134
type: object
98135
properties: {}
99136

137+
- name: initialize_context
138+
description: "Loads persistent memory context and user profile at conversation start."
139+
inputSchema:
140+
type: object
141+
properties: {}
142+
143+
- name: save_memory
144+
description: "Save a memory with AES-256-GCM encryption. Alias for save_to_synapse with tag support."
145+
inputSchema:
146+
type: object
147+
required: [content]
148+
properties:
149+
content:
150+
type: string
151+
description: "The memory content to store securely."
152+
agent_id:
153+
type: string
154+
description: "Agent identifier for memory isolation."
155+
tags:
156+
type: array
157+
description: "Tags for categorization."
158+
items:
159+
type: string
160+
161+
- name: store_memory
162+
description: "Store context, preferences, or facts with AES-256-GCM encryption. Canonical memory persistence endpoint."
163+
inputSchema:
164+
type: object
165+
required: [content]
166+
properties:
167+
content:
168+
type: string
169+
description: "The memory content to store securely."
170+
agent_id:
171+
type: string
172+
description: "Agent identifier. Defaults to 'default'."
173+
tags:
174+
type: array
175+
description: "Tags for categorization."
176+
items:
177+
type: string
178+
179+
- name: recall_memory
180+
description: "Retrieves long-term memory (alias for recall). Supports routing modes and scope filtering."
181+
inputSchema:
182+
type: object
183+
required: [query, reason]
184+
properties:
185+
query:
186+
type: string
187+
description: "What to recall — natural language query."
188+
reason:
189+
type: string
190+
description: "Justification for the recall request (10–200 chars)."
191+
scope:
192+
type: string
193+
description: "Memory scope: 'agent' (default) or 'tenant'."
194+
enum: [agent, tenant]
195+
agent_id:
196+
type: string
197+
description: "Agent identifier for scoped recall."
198+
limit:
199+
type: number
200+
description: "Maximum memories to return (1–50, default: 10)."
201+
mode:
202+
type: string
203+
description: "Recall routing mode."
204+
enum: [auto, temporal, semantic, priority, hybrid]
205+
206+
- name: list_memories
207+
description: "List memory metadata (id, createdAt, tags, summary) without exposing plaintext content."
208+
inputSchema:
209+
type: object
210+
properties:
211+
scope:
212+
type: string
213+
description: "Memory scope: 'agent' (default) or 'tenant'."
214+
enum: [agent, tenant]
215+
agent_id:
216+
type: string
217+
description: "Agent identifier for scoped listing."
218+
limit:
219+
type: number
220+
description: "Maximum rows to return (default: 5, max: 10)."
221+
222+
- name: memory_feedback
223+
description: "Record feedback on a recalled memory to improve future recall quality."
224+
inputSchema:
225+
type: object
226+
required: [memoryId, signal]
227+
properties:
228+
memoryId:
229+
type: string
230+
description: "ID of the memory to provide feedback on."
231+
signal:
232+
type: string
233+
description: "Feedback signal."
234+
enum: [used, ignored, helpful, irrelevant]
235+
sessionId:
236+
type: string
237+
description: "Optional session identifier for tracking."
238+
239+
- name: neural_handover
240+
description: "Neural Handover V2 — Consume a one-time encrypted handover token from another agent context."
241+
inputSchema:
242+
type: object
243+
required: [token, reason]
244+
properties:
245+
token:
246+
type: string
247+
description: "Handover token (64 hex chars). Generated in Forge UI or API."
248+
reason:
249+
type: string
250+
description: "Justification for consuming this handover (10–200 chars)."
251+
consuming_agent:
252+
type: string
253+
description: "Agent identifier consuming the handover."
254+
255+
- name: slo_report
256+
description: "Admin-only SLO observability report with percentile latencies and per-tool breakdown."
257+
inputSchema:
258+
type: object
259+
required: [admin_token]
260+
properties:
261+
admin_token:
262+
type: string
263+
description: "Admin authentication token."
264+
window_hours:
265+
type: array
266+
description: "Time windows in hours (default: [24, 168])."
267+
items:
268+
type: number
269+
100270
tags:
101271
- agent-memory
102272
- persistent-context

0 commit comments

Comments
 (0)