Synaptic Code Intelligence

io.github.ColinVaughnPublished by GitHub account ColinVaughnv1.2.0Updated Oct 25, 2026

Code intelligence for repository graphs, change impact, test selection, and engineering memory.

VerifiedStreamable HTTPWeb executableKnowledge & Memory Developer Tools

Server details

Identifier: io.github.ColinVaughn/synaptic
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account ColinVaughn for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.ColinVaughn%2Fsynaptic.svg)](https://sourceweft.com/mcp/io.github.ColinVaughn%2Fsynaptic?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Synaptic Code Intelligence gives a coding assistant a persistent, source-grounded graph of a repository to answer questions about symbols, dependencies, change,

What you can do: Query a repository graph to understand how a system works, including symbols, calls, imports, inheritance, resources, SQL and cross-language boundaries. Trace impact: callers, references, reverse dependencies, dynamic-dispatch hazards and affected tests. Forecast change risk, plan refactors, diff architecture and optionally verify a change in an isolated worktree. Search source-linked repository history from commits, decisions, incidents, reviews and CI. Track API contracts and vulnerability evidence with small repair workflows.
When to use it: Use it when a coding assistant needs to reason about a large or unfamiliar codebase without loading whole source files into context, or when you want impact analysis, test selection and repository memory across sessions.
Requirements: A remote MCP endpoint at synapticgraph.com over streamable HTTP, with a bearer token from the Synaptic MCP dashboard sent in the Authorization header, including the Bearer prefix. The README also describes a local single-binary CLI with no runtime, database, account or API key.

Before you install

The hosted endpoint requires a bearer token in the Authorization header; treat it as a secret. The README says local extraction honors ignore files, skips common secret files and stays offline unless a network-backed feature is enabled, so check what is sent when using the hosted service. Some workflows can verify changes in a throwaway worktree.

Installation

In SourceWeft

Open Synaptic Code Intelligence in the dashboard and add it to a workspace.
Connect Authorization token credentials. They are stored privately and never shown on public pages.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Follow the launch instructions in the repository.

README

Synaptic

[Join our Discord] [License: AGPL-3.0-or-later] [Latest release]

Give your coding assistant a map of the codebase, not a pile of files.

Synaptic maps a repository once so you and your coding assistant do not have to rediscover it every session. Ask how a system works, what depends on a symbol, or what a change may break. The answers come from a persistent, source-grounded knowledge graph, available from the CLI or through MCP. Synaptic can also remember past changes and plan small, reviewable API and dependency repairs.

Code extraction is local and deterministic. Synaptic ships as a single Rust binary with no runtime, database, account, or API key required.

Documentation | Quickstart | Benchmarks | Discord

Get started

Install the latest checksummed release:

# macOS / Linuxcurl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/ColinVaughn/Synaptic/main/install.sh | sh
# Windows PowerShellirm https://raw.githubusercontent.com/ColinVaughn/Synaptic/main/install.ps1 | iex

# macOS / Linuxcurl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/ColinVaughn/Synaptic/main/install.sh | sh
# Windows PowerShellirm https://raw.githubusercontent.com/ColinVaughn/Synaptic/main/install.ps1 | iex

Then run Synaptic from a repository:

synaptic extract .                         # build synaptic-out/graph.jsonsynaptic query "how does authentication work?"synaptic affected parse_config             # what could this change break?

synaptic extract .                         # build synaptic-out/graph.jsonsynaptic query "how does authentication work?"synaptic affected parse_config             # what could this change break?

Extraction honors .gitignore and .synapticignore, skips common secret files, and stays offline unless you explicitly enable a network-backed feature.

Connect your coding assistant

synaptic install claude                    # Claude Codesynaptic install codex                     # Codex CLIsynaptic install codex --global            # Codex desktop app

synaptic install claude                    # Claude Codesynaptic install codex                     # Codex CLIsynaptic install codex --global            # Codex desktop app

Claude and Codex load only a small set of tools at startup, then find the rest on demand. This keeps prompts smaller without hiding capabilities. Gemini, Cursor, Copilot, OpenCode, Kilo, and generic AGENTS.md clients are supported too. See Assistant Integration.

What it does

Need	What Synaptic provides
Understand the code	Symbols, calls, imports, inheritance, resources, SQL, and cross-language boundaries in one graph
Find impact	Callers, references, reverse dependencies, dynamic-dispatch hazards, and affected tests
Change code safely	Change forecasts, refactor plans, architecture diffs, and optional verification in an isolated worktree
Remember the past	Source-linked history from commits, decisions, incidents, reviews, CI, and previous attempts
Maintain dependencies	API contract tracking and vulnerability evidence with small, reviewable repair workflows

Synaptic supports dozens of languages, incremental updates, multi-repository federation, structural search, SQL auditing, graph-aware PR review, and exports for GraphML, Cypher, Graphviz, Obsidian, and Markdown. Detailed capabilities live in the documentation, keeping this page focused on getting started.

See the architecture

This creates a self-contained architecture map from the graph. Open a subsystem, select a symbol, and follow its real incoming and outgoing relationships without a server.

[Synaptic architecture chart switching themes and opening a subsystem]

Built to save context

Synaptic returns the relevant slice of a graph instead of loading whole source files into an assistant's context. In the checked-in token benchmark, full graph answers used 27-38x fewer tokens than reading the source files referenced by those answers. That is a context-compression measurement, not a promise about total task cost. The methodology and raw results are in BENCHMARKS.md.

Common commands

Command	Purpose
`synaptic extract .`	Build the graph
`synaptic update` / `synaptic watch`	Keep it current
`synaptic query "..."`	Find the relevant subgraph for a question
`synaptic affected <symbol>`	Trace reverse impact
`synaptic predict <files>`	Forecast risk and select tests
`synaptic speculate <files>`	Verify a change in a throwaway worktree
`synaptic memory search "..."`	Find relevant repository history
`synaptic serve`	Run the MCP server

Run synaptic <command> --help for flags or use the complete command reference.

Pick a workflow

CLI: the fastest path for local extraction, queries, automation, and MCP.
Desktop: run synaptic-ui for visual repository setup, federation, assistant connection, updates, and the complete command catalog.
Hosted: Synaptic Cloud provides a managed MCP service. See the GitHub automation guide for commit-triggered graph sync and verified repair workflows.

Update a release installation with synaptic self-update.

Documentation

Installation and Quickstart
Querying, languages, and output formats
MCP server and assistant integration
Repository memory, API maintenance, and vulnerability management
Workspaces and federation, configuration, and development

Build from source

The repository pins Rust 1.97.1.

For development and architecture notes, see the development guide.

Community and license

Questions, ideas, or something you built? Join the Discord community.

Synaptic is licensed under AGPL-3.0-or-later; see LICENSE and NOTICE. If you modify Synaptic and make it available over a network, you must offer those users the corresponding source. The separately maintained Synaptic Cloud service is proprietary and is not covered by this repository's license.

Source: README.md at commit c852b25

Tools

SourceWeft has not read this server's tools yet.

Version history

v1.2.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts