# Weavatrix

> Weavatrix is an open-source MCP server for developer tools. Local code evidence graph and 66 MCP tools for coding agents, offline and native. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://weavatrix.com
- **Repository:** https://github.com/weavatrix/weavatrix
- **MCP Registry name:** io.github.Weavatrix/weavatrix
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Weavatrix builds a graph of a repository covering structure, history, memory and risk, then lets an agent ask grounded questions such as what breaks if the auth middleware changes. The README example shows a `change_impact` result: three changed files mapped to nine symbols, 41 dependents and 7 untested hotspots.

The registry describes 66 tools spanning code, local CI, n8n, Dify, agents, Mermaid and Web3. The site splits the family into four MIT packages with explicit trust boundaries: Core is network-free and source-read-only with 44 read-only tools, SEO is a Search Evidence Graph with 15 tools, Refactor adds reviewed local writes, and Online adds an authorized network connection.

It runs as a native binary with zero runtime dependencies, installed with `npx -y weavatrix mcp <repoRoot>` or from crates.io, and profiles can narrow which tools are exposed.

## Features

- **Repository evidence graph:** Structure, history, intent and risk in one graph.
- **Blast radius:** Find dependents and untested hotspots before a change.
- **Read-only core:** No network path and no source writes in Core.
- **Tool profiles:** Expose only the tools a task needs.
- **Native binary:** Offline, with zero runtime dependencies.

## Good for

- Estimate the impact of changing a module
- Map an unfamiliar application
- Find duplicated code and untested hotspots
- Keep architecture rules enforced as code changes

## Install

### Claude Code (Terminal)

```sh
claude mcp add weavatrix -- npx -y weavatrix
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "weavatrix": {
      "command": "npx",
      "args": [
        "-y",
        "weavatrix"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "weavatrix": {
      "command": "npx",
      "args": [
        "-y",
        "weavatrix"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "weavatrix": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "weavatrix"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "weavatrix": {
      "command": "npx",
      "args": [
        "-y",
        "weavatrix"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "weavatrix": {
      "command": "npx",
      "args": [
        "-y",
        "weavatrix"
      ]
    }
  }
}
```

## Tools

- `change_impact`: Maps changed files to symbols and dependents with ranked blast radius.

## FAQ

### Does it need the network?

Core has no network path; only the separate Online connector does.

### Can it edit my code?

Core cannot. Writes come from the separate Refactor package and need an environment flag.

### How is it installed?

Through npx, or cargo install from crates.io.

### What licence?

The site says all four public packages are MIT.

### Is Weavatrix free?

Yes. Weavatrix is open source, so you can use and self-host it for free.

### How do I add Weavatrix to Claude Code?

Run this command in your terminal: claude mcp add weavatrix -- npx -y weavatrix

### What are the best alternatives to Weavatrix?

The closest alternatives to Weavatrix are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/weavatrix-2
