Tool Reference
Synapses exposes 12 MCP tools over stdio. Every tool accepts and returns JSON. Tools use action, mode, or phase parameters to consolidate related operations into a single entry point.
All Tools
| Tool | Description | Docs |
|---|---|---|
session_init | Single-call session bootstrap. Scopes: standard, full, resume, quick. | Session |
end_session | Capture session knowledge and report usage metrics. | Session |
get_context | Unified context retrieval. Modes: context, intent, path. | Context Retrieval |
get_file_context | All entities in a file ordered by line number. | Context Retrieval |
search | Multi-mode search. Modes: keyword, fulltext, semantic, exact. | Search |
annotate | Unified annotations. Actions: add, add_web, add_gap, list_gaps, history. | Annotate |
get_impact | Blast-radius analysis with reverse-BFS. | Impact |
validate | Unified validation. Phases: pre, post, list, full, safety. | Validation |
tasks | Unified task management. Actions: create_plan, list_plans, pending, update, save_state, get_state, link_nodes. | Tasks |
rules | Unified rule/ADR management. Actions: upsert, delete, candidates, upsert_adr, list_adrs. | Rules |
memory | Unified episodic memory. Actions: save, search, list. | Memory |
lookup_docs | Cached Go package docs or URL content. | Knowledge |
MCP Resources
In addition to tools, Synapses exposes read-only MCP Resources:
| Resource URI | Description |
|---|---|
synapses://edge-types | All edge types with weights and descriptions. |
synapses://analytics | Agent session analytics. |
synapses://query/{q} | Direct graph query. |
synapses://decision-log | Decision log entries. |
Migration from Pre-v1
The 12 tools above replace the previous 66+ tool surface. Removed tools are now actions/modes within consolidated tools. See each tool’s documentation for the mapping.