SiteBay MCP Server

A Model Context Protocol (MCP) server that provides Claude Code users with direct access to the SiteBay WordPress hosting platform. Manage your hosted WordPress sites, execute server commands, and more through natural language interactions with the SiteBay cloud infrastructure.

Features

🌐 Site Management

List all your hosted WordPress sites
Get detailed site information (active, HTTP auth, plan)
Create new WordPress sites using SiteBay's ready-made sites
Update site settings (Cloudflare dev mode, domain, HTTP auth, Git URL)
Delete sites

⚡ Site Operations

Execute shell commands and WP-CLI commands on SiteBay servers
Edit files in wp-content directory on your hosted sites

🛠 Advanced Features

Point-in-time backup restores from SiteBay's backup system (coming soon)
Team management for collaborative hosting (coming soon)
WordPress/Shopify/PostHog API proxy services through SiteBay (coming soon)

🗺 Helper Tools

Browse SiteBay's ready-made sites
Account and billing information (coming soon)

Installation

Installing via Smithery

To install SiteBay MCP for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @sitebay/sitebay-mcp --client claude

Using uvx (Recommended)

# Install and run directly with uvx
uvx sitebay-mcp

# Or install for repeated use
uv tool install sitebay-mcp
sitebay-mcp

HTTP Transport (Recommended for hosted deployments)

This server now supports Streamable HTTP transport in addition to STDIO. Use HTTP for hosted or remote deployments and to comply with Smithery’s hosted requirements.

Run over HTTP

# Defaults to 127.0.0.1:7823
uvx sitebay-mcp --http

# Or specify host/port
uvx sitebay-mcp --http --host 0.0.0.0 --port 7823

# Environment variables also supported
MCP_TRANSPORT=http MCP_HTTP_HOST=0.0.0.0 MCP_HTTP_PORT=7823 uvx sitebay-mcp

Configure Claude Desktop for HTTP

Add a server URL entry instead of a command:

{
  "mcpServers": {
    "sitebay": {
      "url": "http://127.0.0.1:7823",
      "env": {
        "SITEBAY_API_TOKEN": "your_api_token_here"
      }
    }
}
}

Using pip

# Install from PyPI (when published)
pip install sitebay-mcp

# Or install from source
git clone https://github.com/your-username/sitebay-mcp.git
cd sitebay-mcp
pip install -e .

Configuration

1. Get Your SiteBay API Token

Log in to your SiteBay account
Navigate to Settings in your account dashboard
Generate a new API token
Copy the token for use in configuration

2. Configure Claude Desktop

Add the following to your Claude Desktop configuration file:

For uvx installation (STDIO mode):

{
  "mcpServers": {
    "sitebay": {
      "command": "uvx",
      "args": ["sitebay-mcp"],
      "env": {
        "SITEBAY_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

For pip installation (STDIO mode):

{
  "mcpServers": {
    "sitebay": {
      "command": "python",
      "args": ["-m", "sitebay_mcp.server"],
      "env": {
        "SITEBAY_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

For HTTP mode (any installation):

{
  "mcpServers": {
    "sitebay": {
      "url": "http://127.0.0.1:7823",
      "env": {
        "SITEBAY_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

3. Claude Desktop Configuration File Locations

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json

Usage Examples

Creating a New WordPress Site

Claude: Create a new WordPress site on team 00000000-0000-4000-a000-000000000000 with domain "www.example.org". Blog name "Example", admin Jane Smith (email admin@example.org), username "taylor89", password "AStrongPassword". Use ready-made site name "blog-basic" and set Git URL to https://github.com/acme/wp-site

Managing Existing Sites

Claude: List all my WordPress sites and show their current status

Claude: Get detailed information about myblog.example.com

Claude: Enable Cloudflare dev mode for myblog.example.com
Claude: Set the Git URL for myblog.example.com to https://github.com/acme/wp-site
Claude: Turn on HTTP auth for myblog.example.com

Executing Commands

Claude: Run "wp plugin list" on myblog.example.com to see what plugins are installed on the SiteBay server

Claude: Execute "wp search-replace 'http://old-domain.com' 'https://new-domain.com'" on myblog.example.com through SiteBay

Claude: Check the disk usage on myblog.example.com with "df -h" on the SiteBay server

File Management

Claude: Edit the style.css file in my active theme on myblog.example.com hosted on SiteBay

Getting Information

Claude: List all the ready-made sites available on SiteBay for new sites

Available Tools

Site Management

sitebay_list_sites - List all WordPress sites hosted on SiteBay
sitebay_get_site - Get detailed information about a hosted site
sitebay_create_site - Create a new WordPress site on SiteBay infrastructure
sitebay_update_site - Update site configuration on SiteBay servers
sitebay_delete_site - Delete a hosted site

Site Operations

sitebay_site_shell_command - Execute shell/WP-CLI commands on SiteBay servers
sitebay_site_edit_file - Edit files in wp-content on SiteBay-hosted sites

Helper Tools

sitebay_list_ready_made_sites - List ready-made sites available on SiteBay

Security Notes

Your SiteBay API token is stored securely in environment variables
All communications with SiteBay infrastructure use HTTPS encryption
API tokens can be revoked at any time from your SiteBay account dashboard
The MCP server runs locally and only proxies requests to SiteBay - no data is stored locally

Error Handling

The server provides clear error messages for common issues:

Authentication errors: Invalid or expired API tokens
Site not found: When referencing non-existent sites
Validation errors: Invalid parameters or missing required fields
Network errors: Connection issues with SiteBay API

Troubleshooting

Authentication Issues

Verify your API token is correct
Check that the token is properly set in the environment variable
Ensure the token hasn't expired
Try regenerating the token from your SiteBay account

Connection Issues

Check your internet connection
Verify SiteBay service status
Check firewall settings
Try restarting Claude Desktop

Tool Not Found

Restart Claude Desktop after configuration changes
Verify the configuration file is in the correct location
Check the JSON syntax is valid
Ensure uvx or Python is properly installed

Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests for new functionality
Ensure all tests pass and code is properly formatted
Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

Issues: GitHub Issues
Documentation: SiteBay API Docs
SiteBay Support: SiteBay Help Center

Changelog

v0.1.0 (2024-01-XX)

Initial release
Site management tools
Shell command execution
File editing capabilities
External path management
Ready-made site catalog listing

SiteBay