Skip to content
MCP server

Scripthold

Encoding-aware, approval-gated file access for AI agents on local workspaces

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Windows, macOS
Runs
Locally
Version
4.0.1
Listing updated
today

Similar MCP servers

About Scripthold

Scripthold is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "scripthold": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/zoster81/scripthold/releases/download/v4.0.1/scripthold_windows_amd64.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "scripthold": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/zoster81/scripthold/releases/download/v4.0.1/scripthold_windows_amd64.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free, open source (GPL-3.0 lineage)

Scripthold 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.

How AIPoweredBot checks servers