# Scripthold

> Scripthold is an open-source MCP server for developer tools. Encoding-aware, approval-gated file access for AI agents on local workspaces. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Windows, macOS, Linux, self-hosted
- **Repository:** https://github.com/zoster81/scripthold
- **MCP Registry name:** io.github.zoster81/scripthold
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-18

## About

Scripthold gives web, desktop and CLI agents controlled access to directories you explicitly authorise. Its distinguishing job is legacy text encodings: it supports 168 of them with content-based detection, so an agent sees Cyrillic text correctly instead of garbled characters. Version 4.x offers 36 tools and 3 guided prompts.

Changes follow a preview-then-apply pattern with exact fingerprints and conflict checks, and a single confirmation tool approves any prepared operation. Source navigation covers 100 language providers for declarations, structural search and project relations. Optional features include persistent backups with compare and restore, durable asynchronous tasks and authenticated Streamable HTTP, which binds to loopback by default and needs TLS or a trusted proxy beyond that.

It installs as a prebuilt binary or MCPB bundle, a Go build or a hardened container image. The project descends from an earlier file-tools server and keeps its GPL-3.0 lineage.

## Features

- **168 text encodings:** Detects and handles legacy encodings, including UTF-32.
- **Workspace boundaries:** Confines access to authorised roots, including Windows junction handling.
- **Preview and apply:** Requires approval for each mutation with fingerprint checks.
- **Source intelligence:** Navigates declarations and structure across 100 providers.
- **Persistent backups:** Offers history, compare, restore and pinning.
- **Durable tasks:** Runs long jobs with recovery and cancellation.
- **Authenticated HTTP:** Serves Streamable HTTP with bearer tokens and Host checks.

## Good for

- Edit legacy-encoded source files without corrupting them
- Apply multi-file patches only after approval
- Restore a workspace from a backup
- Let a web agent work on a local project safely
- Navigate symbols in a large codebase

## Install

### Claude Code (Terminal)

```sh
claude mcp add scripthold -- npx -y https://github.com/zoster81/scripthold/releases/download/v4.0.1/scripthold_windows_amd64.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "scripthold": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/zoster81/scripthold/releases/download/v4.0.1/scripthold_windows_amd64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "scripthold": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/zoster81/scripthold/releases/download/v4.0.1/scripthold_windows_amd64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "scripthold": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/zoster81/scripthold/releases/download/v4.0.1/scripthold_windows_amd64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "scripthold": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/zoster81/scripthold/releases/download/v4.0.1/scripthold_windows_amd64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "scripthold": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/zoster81/scripthold/releases/download/v4.0.1/scripthold_windows_amd64.mcpb"
      ]
    }
  }
}
```

## Tools

- `read_text_file`: Reads a text file with encoding detection.
- `read_multiple_files`: Reads several files.
- `write_whole_file`: Writes a whole file.
- `edit_file`: Edits a file.
- `grep_text_files`: Searches text across files.
- `confirm_verified_operation`: Approves a prepared operation once.
- `patch_package`: Applies multi-file changes.
- `filesystem_package`: Runs multi-step filesystem changes.
- `list_directory`: Lists a directory.
- `tree`: Shows a directory tree.
- `search_files`: Searches for files.
- `get_file_info`: Returns file metadata.
- `fingerprint_paths`: Fingerprints paths.
- `verify_state`: Verifies workspace state.

## FAQ

### Which encodings does it support?

168 registered text encodings with content-based detection and conservative ambiguity handling.

### How are writes controlled?

Mutations use preview and apply with exact fingerprints and a one-shot confirmation tool.

### Can it run over HTTP?

Yes, Streamable HTTP with bearer authentication, bound to loopback by default.

### What licence applies?

The README says it retains GPL-3.0 lineage.

### Is Scripthold free?

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

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

Run this command in your terminal: claude mcp add scripthold -- npx -y https://github.com/zoster81/scripthold/releases/download/v4.0.1/scripthold_windows_amd64.mcpb

### What are the best alternatives to Scripthold?

The closest alternatives to Scripthold are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers 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.

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