# Synaptic MCP server

> Lets an AI assistant query a repository's code knowledge graph to understand symbols, trace change impact, select tests, and search engineering history.

- Repository: https://github.com/ColinVaughn/Synaptic
- Page: https://hostedmcp.org/servers/colinvaughn/synaptic
- Transport: remote
- Stars: 32
- License: AGPL-3.0
- Latest version: 1.2.0

## Install

### Claude Code

```sh
claude mcp add --transport http synaptic https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "synaptic": {
      "url": "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "synaptic": {
      "type": "http",
      "url": "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"synaptic","type":"http","url":"https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"}'
```

### Codex

```sh
codex mcp add synaptic --url https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.synaptic]
url = "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http synaptic https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "synaptic": {
      "url": "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D",
      "type": "http"
    }
  }
}
```

## FAQ

### Does Synaptic MCP require an API key or database?

No. Synaptic ships as a single Rust binary with no runtime, database, account, or API key required, and code extraction runs locally and offline.

### How do I connect Synaptic to Claude Code or Codex?

Run the install command for your assistant, such as `synaptic install claude` or `synaptic install codex`; use `--global` for the Codex desktop app.

### What can Synaptic tell me about the impact of a code change?

It traces reverse impact for a symbol, forecasts risk, and selects affected tests, with optional verification in an isolated worktree.

### Can Synaptic search past repository history and decisions?

Yes, it builds source-linked history from commits, decisions, incidents, reviews, CI, and previous attempts, searchable with `synaptic memory search`.

### Does Synaptic run an MCP server?

Yes, `synaptic serve` runs the MCP server, and a managed service is also offered via Synaptic Cloud.