# Truthound

> Truthound is an open-source MCP server for analytics and data. Local data quality checks for CSV and Parquet files, run from an AI agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Website:** https://www.truthound-docs.tech/guides/mcp/
- **Repository:** https://github.com/seadonggyun4/truthound
- **MCP Registry name:** io.github.seadonggyun4/truthound
- **Categories:** analytics and data, developer tools
- **Listing updated:** 2026-11-14

## About

This server wraps the Truthound data-validation library so an agent can inspect a data file on your own machine. It runs over stdio, takes a path inside a folder you approve, and returns summaries rather than raw rows. URLs, glob patterns, parent-directory jumps and symlinks under an allowed folder are refused.

The default Local profile has three tools: check_file for missing values and duplicate rows, profile_file for row and column counts, type families and null or unique ratios, and scan_pii, which samples the first 1,000 non-null values per column so reported counts are estimates. A Core profile adds schema learning, drift comparison, masking and validation with custom rules, each behind separate permission approvals. The docs note that a failed quality check still returns ok=true, and that full MCP parity with the Core library is not yet verified.

Supported formats are CSV, Parquet, JSON and line-delimited JSON. Installation goes through the Styxis plugin marketplace for Codex CLI and Claude Code and needs Git, uv and Python 3.11 to 3.13.

## Features

- **Missing and duplicate checks:** check_file runs the built-in null and duplicate checks and reports pass or fail with an issue count.
- **Column profiling:** profile_file returns row and column counts, type families and null or unique ratios.
- **Sampled PII scan:** scan_pii flags likely personal-data columns using the first 1,000 non-null values per column.
- **Folder-scoped access:** Only folders you approve are readable, and installing the plugin grants no data access by itself.
- **Core profile:** Adds schema learning, drift comparison, masking and rule-based validation with extra permissions.
- **Structured errors:** Stable error codes such as access_denied and file_too_large, without internal exception text.

## Good for

- Check a CSV export for nulls and duplicate rows before loading it
- Profile an unfamiliar Parquet file's columns and types
- Find columns that look like emails or other personal data
- Compare a new batch against a reference dataset for drift (Core)

## Install

### Claude Code (Terminal)

```sh
claude mcp add truthound -- uvx truthound
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `check_file`: Checks a file for missing values and duplicate rows.
- `profile_file`: Summarises rows, columns, type families and null or unique ratios.
- `scan_pii`: Samples columns for likely personal-data types.
- `validation_check`: Core: validates a file against specified rules.
- `data_profile`: Core: summarises column types and quality.
- `privacy_scan`: Core: finds columns suspected of holding PII.
- `data_mask`: Core: masks values such as emails by hashing without altering the source file.
- `schema_learn`: Core: learns a schema from data.
- `drift_compare`: Core: compares a baseline and a new batch for drift.

## FAQ

### Does it send my data anywhere?

No. The server runs locally over stdio and calls the library on your computer; the docs say it is not a remote HTTP or OAuth connector.

### Which file types work?

CSV, Parquet, JSON, NDJSON and JSONL.

### How is PII counted?

By sampling the first 1,000 non-null values per column, so the numbers are estimates.

### What do I need installed?

Git, uv and Python 3.11 to 3.13, plus a client that supports plugins such as Codex CLI or Claude Code.

### Is Truthound free?

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

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

Run this command in your terminal: claude mcp add truthound -- uvx truthound

### What are the best alternatives to Truthound?

The closest alternatives to Truthound 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.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [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.

---
Source: https://ai-powered.com/mcp/truthound
