Which integrations are available for this server?

Enables triggering Git deployments for WordPress sites managed via the SpinupWP infrastructure. Allows for restarting the MySQL service on specific SpinupWP servers. Allows for restarting the NGINX service on specific SpinupWP servers. Allows for restarting the PHP service on specific SpinupWP servers. Allows for restarting the Redis service on specific SpinupWP servers. Provides comprehensive tools for managing WordPress sites, including site provisioning, detailed retrieval, cache purging, and file permission correction.

How do I use SpinupWP MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@SpinupWP MCP Server purge the page cache for example.com" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

SpinupWP MCP Server

A Model Context Protocol (MCP) server integration for the SpinupWP v1 JSON API. This allows AI assistants (like Claude, Cursor, and custom agents) to seamlessly observe and control your SpinupWP infrastructure.

Features

This server currently exposes the following tools:

list_servers: List all SpinupWP servers and their hardware/update status.
get_server: Retrieve detailed information for a specific server.
reboot_server: Reboot a specific SpinupWP server.
restart_service: Restart a specific service (nginx, php, mysql, redis) on a server.
list_sites: List all WordPress sites hosted on a specific server.
get_site: Retrieve detailed information for a specific WordPress site.
purge_site_cache: Purge the page cache for a specific WordPress site.
run_site_git_deployment: Trigger a Git deployment for a specific site.
correct_site_file_permissions: Correct the file permissions for a site.
list_events: List recent SpinupWP events (async background tasks).
get_event: Get the specific details and status of a single event ID.
list_ssh_keys: List the SSH keys configured in the SpinupWP account.
add_ssh_key: Add a new SSH public key for server access.
create_site: Provision a brand new WordPress site on a server.
delete_site: Delete an existing site.
create_server: Provision a brand new custom server.
delete_server: Delete a server entirely.

Prerequisites

Node.js (v18 or newer recommended).
A SpinupWP API Token. You can generate this from the "API Tokens" tab in your SpinupWP account settings.

Installation

Clone this repository:
git clone https://github.com/farukgaric/spinupwp-mcp.git cd spinupwp-mcp
Install dependencies:
npm install
Build the TypeScript files:
npm run build
Configure your environment: Copy .env.example to .env and insert your SpinupWP API token.
cp .env.example .env
Edit .env:
SPINUPWP_API_TOKEN=your_actual_token_here

Usage

This server is designed to be consumed by an MCP client over standard I/O (stdio).

Example: Claude Desktop Configuration

Update your claude_desktop_config.json (on macOS, usually located at ~/Library/Application Support/Claude/claude_desktop_config.json):

{ "mcpServers": { "spinupwp-local": { "command": "node", "args": [ "/absolute/path/to/spinupwp-mcp/build/index.js" ] } } }

(Ensure you use the absolute path to your cloned repository.)

Development

Start the server manually (ensure your .env is loaded):
npm start
To make changes to the tools, edit src/index.ts and rebuild using npm run build.