# HonestCode MCP server

> Provides a deterministic verification layer for AI coding agents to catch invented APIs, undefined symbols, and incorrect method calls.

- Repository: https://github.com/Fengrru/honestcode
- Page: https://hostedmcp.org/servers/fengrru/honestcode
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.5.1

## Install

### Claude Code

```sh
claude mcp add honestcode -- uvx honestcode
```

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

```json
{
  "mcpServers": {
    "honestcode": {
      "command": "uvx",
      "args": [
        "honestcode"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "honestcode": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "honestcode"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "honestcode": {
      "command": "uvx",
      "args": [
        "honestcode"
      ]
    }
  }
}
```

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

```toml
[mcp_servers.honestcode]
command = "uvx"
args = ["honestcode"]
```

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

```json
{
  "mcpServers": {
    "honestcode": {
      "command": "uvx",
      "args": [
        "honestcode"
      ]
    }
  }
}
```

## Tools (7)

- `scan_file`
- `verify_file`
- `index_project`
- `load_project_deps`
- `check_symbol`
- `check_api`
- `validate_types`

## FAQ

### How does HonestCode differ from Ruff or Pyright?

While Ruff and Pyright check syntax and types, HonestCode provides repository grounding to verify if an agent's code actually uses real symbols existing in the specific codebase.

### Does HonestCode require LLM calls or network access?

No, it operates entirely locally using AST and symbol resolution without any LLM calls or network requirements.

### Can I use HonestCode with Claude Desktop or Cursor?

Yes, the `honestcode install` command can automatically probe and register the server for Claude Desktop, Cursor, and VS Code.