Wisp MCP server
Commit Oct 29, 2026Allows an AI client to manage game servers by inspecting resources, reading logs, and performing administrative actions through the WISP Client API.
Also known as BreezeDelegate/wisp-mcp, wisp-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.4.1
- Last commit
- Oct 29, 2026
- License
- —
What is Wisp MCP?
Wisp allows an AI client to manage game servers by inspecting resources, reading logs, and performing administrative actions through the WISP Client API.
Summary generated from the project's README
About Wisp MCP server
Wisp MCP provides a bridge between AI clients and game servers hosted on WISP panels. It allows users to manage various games like Minecraft and Rust by interacting with the WISP Client API. This tool is designed for server administrators who want to use an AI assistant to monitor resources, inspect logs, and perform administrative tasks without needing direct shell access or SSH.
To use this server, you must have a WISP panel URL and a Client API token from your hosting provider. The installation requires Python 3.11 or higher and can be set up locally on Windows or Linux. Users can connect through ChatGPT using a secure tunnel, via Claude Code, or through other MCP clients using stdio or authenticated Streamable HTTP.
Functionality is controlled through specific environment flags to manage risk. While basic tasks like listing servers and reading files are standard, you can optionally enable capabilities for writing files, running console commands, or managing backups. The system includes SHA-256 guarded writes to detect changes during file editing, though it does not replace the need for manual backups.
What you can do with it
- 1Monitor server health and logsAsk the AI to check resource usage and search through server logs for errors.
- 2Manage game server filesInstruct the AI to browse directories or search for specific configuration files.
- 3Execute administrative commandsRequest the AI to run console commands or change the power state of a game server.
- 4Handle database and backup tasksHave the AI create new backups or perform database operations.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablebreezedelegate/wisp-mcp is public and reachablegithub.com/breezedelegate/wisp-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-10-29github.com/breezedelegate/wisp-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubWisp MCP
Use a WISP game panel from an MCP-compatible AI client.
Wisp MCP connects to the WISP Client API. It can inspect game servers, read logs and files, and perform selected administrative actions through the panel. It does not provide shell access to the underlying host.
Français · Setup · AI clients · Security
Is this for my server?
Your hosting provider must use WISP and let you create a Client API token. The host may have customized the panel branding.

The integration works with the panel's API, regardless of which company hosts it. It can manage Minecraft, Rust, and other games exposed through the same panel. It is not a Pterodactyl, Docker, or general SSH integration.
What you can do
| Task | Access |
|---|---|
| List servers, inspect resources and audit logs | Read |
| Browse directories, read files and search logs | Read |
| Write files, run console commands, change power state | Optional |
| Create and inspect backups; access database operations | Optional |
| Delete files, restore/delete backups, or change destructive settings | Separate destructive capability |
Large-file reads can be bounded. Existing text files support SHA-256 guarded writes, to detect changes between reading and editing. These checks do not replace a backup.
Important: enabling console commands or file writes can still cause harmful changes, even with the destructive capability disabled. A Client API token can also expose sensitive data in logs or configuration files. Keep tokens private and enable the smallest capabilities you need.
Install locally
Requirements: Python 3.11+, Git, a WISP panel URL, and a WISP Client API token.
git clone https://github.com/BreezeDelegate/wisp-mcp.git
cd wisp-mcp
./setup.sh
For Windows, use setup.ps1 in PowerShell. The setup prompts for your panel URL and token and stores them in a user-only configuration file.
Check the connection:
wisp-mcp doctor
This checks API access without modifying the game server. See the step-by-step setup for details.
Linux VPS: an optional installer can set up a dedicated service user. Review the script before running it with elevated privileges. The VPS guide covers remote deployment.
Connect your AI client
- ChatGPT: follow the secure tunnel setup.
- Claude Code: see client setup.
- Other MCP clients: use stdio locally or authenticated Streamable HTTP remotely.
Start in read-only mode. To enable specific actions later, configure the corresponding WISP_ALLOW_* environment flags. Keep WISP_ALLOW_DESTRUCTIVE=false during routine use.
The server's HTTP transport requires an allowed-host configuration when exposed remotely. Use TLS and a bearer token; avoid public unauthenticated endpoints.
Project information
- Configuration and operations
- Panel compatibility checks
- API compatibility checks
- Report a security issue
- Contribute
- Releases
- MCP Registry
License
PolyForm Noncommercial 1.0.0. The source is available, but commercial use is not granted by the public license. See LICENSE for the full terms and required notice. Commercial licensing requires separate permission from the rights holder.
Wisp MCP questions
What kind of games can I manage?
It can manage Minecraft, Rust, and other games that are exposed through the WISP panel.
Does this provide shell access to my host?
No, the server provides administrative actions through the panel but does not provide shell access to the underlying host.
Is this compatible with Pterodactyl?
No, this is specifically for WISP panels and is not a Pterodactyl, Docker, or general SSH integration.