Skip to main content
Glama
gridpane-mcp

gridpane-mcp

by fenil0020

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

Related MCP server: easypanel-mcp-server

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

Available Tools

16 tools
change_php_versionB

Change PHP version for a site. Common versions: 7.4, 8.0, 8.1, 8.2, 8.3

Inputs: site_id (required), php_version (required). Returns: result

get_serverA

Get detailed info for a specific server by its ID.

Inputs: server_id (required). Returns: result

get_siteB

Get detailed info for a specific site by its ID.

Inputs: site_id (required). Returns: result

list_serversA

List all GridPane servers with their IPs, status, and site counts.

Inputs: no named parameters. Returns: result

list_sitesC

List all WordPress sites across all servers.

Inputs: per_page. Returns: result

purge_site_cacheC

Purge all server-level caches for a site.

Inputs: site_id (required). Returns: result

restart_mysqlC

Restart MySQL/MariaDB/Percona on a server.

Inputs: server_id (required). Returns: result

restart_nginxC

Restart Nginx on a server.

Inputs: server_id (required). Returns: result

restart_phpC

Restart PHP-FPM on a server for a specific PHP version.

Inputs: server_id (required), php_version. Returns: result

search_serverA

Search for a server by name (partial match). Returns matching servers with their sites.

Inputs: name (required). Returns: result

search_siteB

Search for a site by domain name (partial match).

Inputs: domain (required). Returns: result

toggle_debugB

Toggle WordPress debug mode for a site.

Inputs: site_id (required). Returns: result

toggle_site_cacheC

Toggle Nginx caching for a site.

Inputs: site_id (required). Returns: result

toggle_sslC

Toggle SSL on/off for a site.

Inputs: site_id (required). Returns: result

trigger_backupC

Trigger a manual backup for a site.

Inputs: site_id (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 16 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, but there is slight overlap between list_servers/search_server and list_sites/search_site. However, descriptions clarify the difference (full list vs partial match), so overall ambiguity is low.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with lowercase and underscores, e.g., change_php_version, list_servers, toggle_ssl. No mixed conventions or irregularities.

    Tool Count5/5

    16 tools cover a wide range of server and site management operations without being excessive. Each tool serves a distinct purpose and the count is well-scoped for the domain.

    Completeness4/5

    The tool set covers essential operations like server/site info, cache, SSL, PHP, backups, and service restarts. Missing are lifecycle operations (create/delete) and backup status, but the set is sufficient for typical admin tasks.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A comprehensive MCP server for WordPress automation that enables users to manage content, themes, and site configurations using AI-driven workflows and the WordPress REST API. It provides a wide array of tools for site planning, management, and optimization compatible with tools like Cursor and Claude.
      48 npm
      1
      ISC
    • A
      license
      B
      quality
      C
      maintenance
      MCP Server for full Easypanel control via Claude Code, Cursor, and Claude Desktop. Provides 37 tools for deploy, logs, env vars, domains, databases, and monitoring with built-in safety guards.
      57
      309 npm
      4
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      MCP server for Cloudways enabling server management, app deployment, backups, SSL, environment variables, and monitoring via Claude Code.
      12
      MIT