NestDaddy

Ghost Inspector Mcp

io.github.charliemtnez/ghost-inspector-mcp · v0.4.1

Analyze, validate and safely update Ghost Inspector end-to-end browser tests

Connect Runs on your machine

Terminal
claude mcp add ghost-inspector-mcp -e GHOST_INSPECTOR_API_KEY=<GHOST_INSPECTOR_API_KEY> -e GHOST_INSPECTOR_ORG_ID=<GHOST_INSPECTOR_ORG_ID> -e GHOST_INSPECTOR_ALLOW_WRITES=<GHOST_INSPECTOR_ALLOW_WRITES> -e GHOST_INSPECTOR_ALLOW_RUNS=<GHOST_INSPECTOR_ALLOW_RUNS> -e GHOST_INSPECTOR_BACKUP_DIR=<GHOST_INSPECTOR_BACKUP_DIR> -- npx -y [email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "ghost-inspector-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "GHOST_INSPECTOR_API_KEY": "<GHOST_INSPECTOR_API_KEY>",
        "GHOST_INSPECTOR_ORG_ID": "<GHOST_INSPECTOR_ORG_ID>",
        "GHOST_INSPECTOR_ALLOW_WRITES": "<GHOST_INSPECTOR_ALLOW_WRITES>",
        "GHOST_INSPECTOR_ALLOW_RUNS": "<GHOST_INSPECTOR_ALLOW_RUNS>",
        "GHOST_INSPECTOR_BACKUP_DIR": "<GHOST_INSPECTOR_BACKUP_DIR>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "ghost-inspector-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "GHOST_INSPECTOR_API_KEY": "<GHOST_INSPECTOR_API_KEY>",
        "GHOST_INSPECTOR_ORG_ID": "<GHOST_INSPECTOR_ORG_ID>",
        "GHOST_INSPECTOR_ALLOW_WRITES": "<GHOST_INSPECTOR_ALLOW_WRITES>",
        "GHOST_INSPECTOR_ALLOW_RUNS": "<GHOST_INSPECTOR_ALLOW_RUNS>",
        "GHOST_INSPECTOR_BACKUP_DIR": "<GHOST_INSPECTOR_BACKUP_DIR>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "ghost-inspector-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "GHOST_INSPECTOR_API_KEY": "<GHOST_INSPECTOR_API_KEY>",
        "GHOST_INSPECTOR_ORG_ID": "<GHOST_INSPECTOR_ORG_ID>",
        "GHOST_INSPECTOR_ALLOW_WRITES": "<GHOST_INSPECTOR_ALLOW_WRITES>",
        "GHOST_INSPECTOR_ALLOW_RUNS": "<GHOST_INSPECTOR_ALLOW_RUNS>",
        "GHOST_INSPECTOR_BACKUP_DIR": "<GHOST_INSPECTOR_BACKUP_DIR>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
GHOST_INSPECTOR_API_KEY
Required, secret
Your personal Ghost Inspector key, from Account Settings then API Access. Read fresh on every call, never written to disk, never echoed back.
GHOST_INSPECTOR_ORG_ID
Optional
Organization id. Needed only to execute a validation; read it from gi_whoami.
GHOST_INSPECTOR_ALLOW_WRITES
Optional
Set to exactly true to let the five write tools act. They are listed either way; anything else keeps the server read-only.
GHOST_INSPECTOR_ALLOW_RUNS
Optional
Set to "true" to let gi_run_test execute a stored test against a real environment, which can submit a real form. Deliberately not implied by GHOST_INSPECTOR_ALLOW_WRITES: an edit can be rolled back from the backup this server returns, a submission cannot. Defaults to false.
GHOST_INSPECTOR_BACKUP_DIR
Optional
Where the write path saves the prior definition of every test it touches, credentials removed. Defaults to ~/.ghost-inspector-mcp/backups, created owner-only.

Details

Package[email protected] (NPM, stdio)
First published28 Sep 2026
Last updated28 Sep 2026
Registry nameio.github.charliemtnez/ghost-inspector-mcp

More browser automation servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.