# candor

> candor is an open-source MCP server for developer tools. Map which functions reach network, files, database or subprocess, then gate risky edits. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux
- **Website:** https://candor.poly.io
- **Repository:** https://github.com/tombaldwin/candor-ts
- **MCP Registry name:** io.github.tombaldwin/candor
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-14

## About

candor builds a precomputed map of what every function can reach, traced through call chains: network, filesystem, database, clock, subprocess and similar effects. Where it cannot resolve a callee, for example a callback or an `any`-typed call, it reports a disclosed Unknown rather than treating the code as pure. An agent asks questions such as the blast radius of a change or what reaches the network and gets a deterministic answer from that map instead of tracing call graphs by hand.

Once you declare a boundary, the map becomes a gate: an edit that crosses it fails the build, and a baseline guard fails a scan when an existing function gains an effect. A policy can also be applied to a dependency's published report without its source, which the site pitches for catching supply-chain changes.

`candor scan` picks an engine from the manifest. Rust, JVM, Swift and TypeScript engines exist, and `candor mcp` reads whichever report is in `.candor/`. This registry entry is the npm candor-ts package. It can be locked to one workspace with `CANDOR_ROOT`.

## Features

- **Effect map per function:** Shows which functions reach Net, Fs, Db, Exec, Clock and more, transitively.
- **Blast radius queries:** Lists the transitive callers of a function before it is changed.
- **Policy gate:** Fails the build when an edit crosses a declared boundary.
- **Baseline guard:** Fails a scan if an existing function gained an effect.
- **Disclosed unknowns:** Unresolved calls are reported, never silently treated as pure.
- **Dependency diff:** Applies a policy to a dependency's published report without its source.

## Good for

- Ask an agent what reaches the database before refactoring
- Enforce that a domain layer does no I/O in CI
- Flag a dependency release that adds network access
- Rank the blind spots where analysis could not resolve a call

## Install

### Claude Code (Terminal)

```sh
claude mcp add candor -- npx -y candor-ts
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## FAQ

### Which languages does it cover?

The site lists Rust, the JVM, Swift and TypeScript engines.

### Does it need a network call to work?

The site says the setup snippet comes from the copy on your machine, and the scan writes the map to .candor/report.json.

### How do I install it?

`brew install tombaldwin/tap/candor`, then `candor scan .` and `candor mcp install`.

### How do I limit it to one project?

Set CANDOR_ROOT to lock the server to a workspace.

### Is candor free?

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

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

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

### What are the best alternatives to candor?

The closest alternatives to candor 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/candor
