Scripthold
Encoding-aware, approval-gated file access for AI agents on local workspaces
- 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.mcpbAdd 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"
]
}
}
}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"
]
}
}
}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.


