gridpane-mcp

A Model Context Protocol (MCP) server for the GridPane hosting platform API. Manage your WordPress servers and sites through Claude, Cursor, or any MCP-compatible client.

Features

Server Management

• list_servers — List all servers with IPs, status, and site counts
• get_server — Get detailed server info by ID
• search_server — Find servers by name (partial match)
• restart_nginx — Restart Nginx on a server
• restart_php — Restart PHP-FPM for a specific PHP version
• restart_mysql — Restart MySQL/MariaDB/Percona

Site Management

• list_sites — List all WordPress sites across all servers
• get_site — Get detailed site info by ID
• search_site — Find sites by domain name (partial match)
• toggle_ssl — Toggle SSL on/off
• toggle_site_cache — Toggle Nginx caching
• purge_site_cache — Purge all server-level caches
• toggle_debug — Toggle WordPress debug mode
• change_php_version — Change PHP version (7.4, 8.0, 8.1, 8.2, 8.3)
• get_sso_link — Get a Single Sign-On link to wp-admin
• trigger_backup — Trigger a manual backup

Prerequisites

• A GridPane account (Developer plan or above)
• A GridPane API token (Settings > GridPane API > Create New Token)

Installation

pip install gridpane-mcp

Or with uv:

uv pip install gridpane-mcp

Configuration

Set your GridPane API token as an environment variable:

export GRIDPANE_API_TOKEN="your_token_here"

Claude Code

claude mcp add gridpane -e GRIDPANE_API_TOKEN=your_token_here -- gridpane-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "gridpane": {
      "command": "gridpane-mcp",
      "env": {
        "GRIDPANE_API_TOKEN": "your_token_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "gridpane": {
      "command": "gridpane-mcp",
      "env": {
        "GRIDPANE_API_TOKEN": "your_token_here"
      }
    }
  }
}

Usage Examples

Once connected, you can ask your AI assistant things like:

• "List all my GridPane servers"
• "Find sites with 'supple' in the domain"
• "Purge cache for site ID 661035"
• "Restart Nginx on the accesshealth server"
• "What PHP version is accesshealth.com.au running?"
• "Toggle debug mode on site 661035"

Environment Variables

Variable	Default	Description
GRIDPANE_API_TOKEN	(required)	Your GridPane API personal access token
GRIDPANE_API_URL	https://my.gridpane.com/oauth/api/v1	GridPane API base URL

License

MIT