Skip to content
Spine Docs

MCP tools

The orchestrator-mcp server exposes Spine to assistants like Claude Code and Codex — 32 tools total: 8 read-only comprehension tools, plus gated SDLC tools that write only after a human approval.

Install

Terminal window
pip install 'synaptixs-spine[all]'

Use [all] — [mcp] alone installs the server with a Python-only graph, so a Java, Go or C# repo would come back empty. Then register the plugin with your assistant and ask about your repo in plain language — the assistant picks the tool.

The registry has 32 tools. Beyond the 8 comprehension tools below, read-only additions include pkg_joins (cross-repo topology), read_memory_bank, pkg_grounding, ingest_preview, understand_repo, profile_repo, design_change and sdlc_baseline; the gated tier adds sdlc_plan and sdlc_approve alongside sdlc_feature, the autonomous-run tools, the registry_* operator tools, and the post-PR tools sdlc_address_review, sdlc_complete and sdlc_remediate.

Read-only comprehension (8)

These write nothing and need no credentials:

map_repo · blast_radius · explain_symbol · investigate · localize · regression_gaps · root_cause · docs_for

See Comprehension for the question each one answers.

Gated SDLC tools

The remaining tools complete the 32 total. They perform actions — branch, codegen, tests, PR — and every one of them stops at a governance gate. Nothing is written to the outside world without an explicit human approval.