Kinsta MCP

Model Context Protocol (MCP) server for Kinsta WordPress hosting

Kinsta MCP Server

A Model Context Protocol (MCP) server for the Kinsta WordPress hosting platform.

This server allows AI assistants (like Claude) to interact with your Kinsta sites and infrastructure securely via the Kinsta API.

Quick Start

Prerequisites

Node.js v22 or higher
A Kinsta account with API access
A Kinsta API key (see Generate an API Key)

Step 1: Generate a Kinsta API Key

Log in to MyKinsta
Go to Your name > Company settings > API Keys
Click Create API Key
Choose an expiration and give the key a name
Click Generate and copy the key (it's only shown once)

You'll also need your Company ID, which can be found in MyKinsta under Company settings.

Step 2: Configure Your MCP Client

Choose the setup that matches your MCP client:

Claude Desktop (Recommended)

Add to your claude_desktop_config.json:

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

{
  "mcpServers": {
    "kinsta": {
      "command": "npx",
      "args": ["-y", "kinsta-mcp"],
      "env": {
        "KINSTA_API_KEY": "your-api-key",
        "KINSTA_COMPANY_ID": "your-company-id"
      }
    }
  }
}

Claude Code (CLI)

Add to your Claude Code MCP settings (~/.claude/mcp.json or project-level):

{
  "mcpServers": {
    "kinsta": {
      "command": "npx",
      "args": ["-y", "kinsta-mcp"],
      "env": {
        "KINSTA_API_KEY": "your-api-key",
        "KINSTA_COMPANY_ID": "your-company-id"
      }
    }
  }
}

Cursor

In Cursor settings, add an MCP server:

{
  "mcpServers": {
    "kinsta": {
      "command": "npx",
      "args": ["-y", "kinsta-mcp"],
      "env": {
        "KINSTA_API_KEY": "your-api-key",
        "KINSTA_COMPANY_ID": "your-company-id"
      }
    }
  }
}

Configuration Reference

Environment Variables

Variable	Required	Default	Description
`KINSTA_API_KEY`	Yes	-	Kinsta API key (Bearer token)
`KINSTA_COMPANY_ID`	Yes	-	Your Kinsta company ID
`KINSTA_API_BASE_URL`	No	`https://api.kinsta.com/v2`	API base URL (override for testing)

Features

Tools

The server provides 83 tools organized by category:

Connectivity

Tool	Description
`kinsta.ping`	Check server status and API credential configuration

Authentication

Tool	Description
`kinsta.auth.validate`	Validate the current Kinsta API key and return account information if valid

Operations

Tool	Description
`kinsta.operations.status`	Check the status of an asynchronous Kinsta operation by operation ID

Company

Tool	Description
`kinsta.company.users`	List all users in your Kinsta company
`kinsta.company.regions`	List all available deployment regions for your Kinsta company
`kinsta.company.api-keys`	List all API keys for your Kinsta company
`kinsta.company.activity-logs`	List company activity logs (supports filtering and pagination)
`kinsta.company.plugins`	List WordPress plugins across all sites (supports search/filter/pagination)
`kinsta.company.themes`	List WordPress themes across all sites (supports search/filter/pagination)

Sites

Tool	Description
`kinsta.sites.list`	List all WordPress sites (optionally include environment details)
`kinsta.sites.get`	Get details for a specific Kinsta site by ID
`kinsta.sites.create`	Create a new WordPress site (returns an `operation_id`)
`kinsta.sites.create-plain`	Create a new plain (empty) site without WordPress installed (returns an `operation_id`)
`kinsta.sites.clone`	Clone an existing site (returns an `operation_id`)
`kinsta.sites.delete`	Delete a Kinsta site permanently (cannot be undone)
`kinsta.sites.reset`	Reset a site to a fresh WordPress install (destructive)

Environments

Tool	Description
`kinsta.environments.list`	List all environments for a site
`kinsta.environments.create`	Create a new WordPress environment for a site (returns an `operation_id`)
`kinsta.environments.create-plain`	Create a new plain (empty) environment for a site (returns an `operation_id`)
`kinsta.environments.clone`	Clone an existing environment (returns an `operation_id`)
`kinsta.environments.push`	Push one environment to another (destructive; returns an `operation_id`)
`kinsta.environments.delete`	Delete an environment (cannot be undone)
`kinsta.environments.php-allocation`	Change PHP worker allocation for an environment (returns an `operation_id`)
`kinsta.environments.php-allocation-site`	Change PHP worker allocation for all environments in a site (returns an `operation_id`)
`kinsta.environments.webroot`	Change the webroot subfolder for an environment (returns an `operation_id`)
`kinsta.environments.files`	List files in an environment's file system
`kinsta.environments.redirects`	List redirect rules for an environment (supports filtering/pagination)
`kinsta.environments.redirects.update`	Create, update, or delete redirect rules for an environment
`kinsta.environments.ssh.status`	Get SSH/SFTP status for an environment
`kinsta.environments.ssh.toggle`	Enable or disable SSH/SFTP access for an environment
`kinsta.environments.ssh.password-access`	Enable or disable SSH password-based access
`kinsta.environments.ssh.generate-password`	Generate a new SSH/SFTP password
`kinsta.environments.ssh.password`	Get the current SSH/SFTP password
`kinsta.environments.ssh.ip-allowlist`	Get the SSH IP allowlist
`kinsta.environments.ssh.ip-allowlist.update`	Update the SSH IP allowlist
`kinsta.environments.ssh.config`	Get SSH connection configuration for an environment
`kinsta.environments.ssh.password-expiration`	Change SSH password expiration interval
`kinsta.environments.wp-cli`	Run a WP-CLI command on an environment (must start with `wp` )
`kinsta.environments.phpmyadmin`	Get a phpMyAdmin login token for an environment

Tool	Description
`kinsta.tools.clear-cache`	Clear the server cache for an environment (returns an `operation_id`)
`kinsta.tools.restart-php`	Restart PHP for an environment (returns an `operation_id`)
`kinsta.tools.php-version`	Change the PHP version for an environment (returns an `operation_id`)
`kinsta.tools.denied-ips`	Get the list of denied (blocked) IP addresses for an environment
`kinsta.tools.denied-ips.update`	Update the list of denied (blocked) IP addresses for an environment

Plugins & Themes

Tool	Description
`kinsta.plugins.list`	List all plugins for an environment
`kinsta.plugins.update`	Update a single plugin (returns an `operation_id`)
`kinsta.plugins.bulk-update`	Update multiple plugins at once (returns an `operation_id`)
`kinsta.plugins.list-wp`	List plugins with details from the WordPress.org repository
`kinsta.themes.list`	List all themes for an environment
`kinsta.themes.update`	Update a single theme (returns an `operation_id`)
`kinsta.themes.bulk-update`	Update multiple themes at once (returns an `operation_id`)
`kinsta.themes.list-wp`	List themes with details from the WordPress.org repository

Domains

Tool	Description
`kinsta.domains.list`	List all custom domains for an environment
`kinsta.domains.add`	Add a custom domain to an environment
`kinsta.domains.delete`	Remove custom domains from an environment
`kinsta.domains.verification`	Get DNS verification records for a domain
`kinsta.domains.set-primary`	Set the primary domain for an environment

DNS (Kinsta DNS)

Tool	Description
`kinsta.dns.domains`	List all DNS domains for your company
`kinsta.dns.records`	List DNS records for a domain
`kinsta.dns.records.create`	Create a new DNS record
`kinsta.dns.records.update`	Update an existing DNS record
`kinsta.dns.records.delete`	Delete a DNS record

Edge Cache & CDN

Tool	Description
`kinsta.edge-cache.clear`	Clear the edge cache for an environment (returns an `operation_id`)
`kinsta.edge-cache.toggle`	Enable or disable edge caching for an environment
`kinsta.cdn.clear-cache`	Clear the CDN cache for an environment (returns an `operation_id`)
`kinsta.cdn.image-optimization`	Configure CDN image optimization settings

SFTP Users

Tool	Description
`kinsta.sftp-users.list`	List additional SFTP/SSH user accounts for an environment
`kinsta.sftp-users.toggle`	Enable or disable additional SFTP/SSH accounts
`kinsta.sftp-users.add`	Add a new additional SFTP/SSH user account
`kinsta.sftp-users.remove`	Remove an additional SFTP/SSH user account

Backups

Tool	Description
`kinsta.backups.list`	List all backups for an environment
`kinsta.backups.downloadable`	List downloadable backups for an environment
`kinsta.backups.create`	Create a manual backup (returns an `operation_id`)
`kinsta.backups.restore`	Restore an environment from a backup (destructive; returns an `operation_id`)
`kinsta.backups.delete`	Delete a backup (cannot be undone)

Analytics

Tool	Description
`kinsta.analytics.visits`	Get visitor analytics for an environment over a date range
`kinsta.analytics.visits-usage`	Get visitor usage analytics (billable visits)
`kinsta.analytics.bandwidth`	Get bandwidth analytics for an environment over a date range
`kinsta.analytics.bandwidth-usage`	Get bandwidth usage analytics (billable bandwidth)
`kinsta.analytics.cdn-bandwidth`	Get CDN bandwidth analytics for an environment over a date range
`kinsta.analytics.cdn-bandwidth-usage`	Get CDN bandwidth usage analytics (billable CDN bandwidth)
`kinsta.analytics.disk-space`	Get disk space usage analytics for an environment

Logs

Tool	Description
`kinsta.logs.get`	Get log file contents for an environment

Resources

The server exposes data as MCP resources:

Static Resources

Resource URI	Description
`kinsta://sites`	List all WordPress sites in your Kinsta company
`kinsta://regions`	List available deployment regions

Resource Templates

Resource URI	Description
`kinsta://sites/{site_id}`	Details for a specific site
`kinsta://sites/{site_id}/environments`	Environments for a specific site

Prompts

The server provides guided prompts for common workflows:

Prompt	Description
`deploy-site`	Guide through creating a new WordPress site on Kinsta
`manage-backups`	Guide for backup list, create, restore, download, and delete workflows
`push-environment`	Guide for pushing changes between environments (e.g. staging to live)
`setup-domain`	Guide for adding a custom domain to a Kinsta environment

Development

Setup

# Clone the repo
git clone https://github.com/jacob-hartmann/kinsta-mcp.git
cd kinsta-mcp

# Use the Node.js version from .nvmrc
# (macOS/Linux nvm): nvm install && nvm use
# (Windows nvm-windows): nvm install 22 && nvm use 22
nvm install
nvm use

# Install dependencies
pnpm install

# Copy .env.example and configure
cp .env.example .env
# Edit .env with your API key and company ID

Running Locally

# Development mode (auto-reload)
pnpm dev

# Production build
pnpm build

# Production run
pnpm start

Debugging

You can use the MCP Inspector to debug the server:

# Run from source
pnpm inspect

# Run from built output
pnpm inspect:dist

pnpm inspect loads .env automatically via dotenv (see .env.example).

If you see Ignored build scripts: esbuild..., run pnpm approve-builds and allow esbuild. In CI we install dependencies with lifecycle scripts disabled (pnpm install --ignore-scripts) and then explicitly rebuild only esbuild for the production build job.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines on how to contribute to this project.

Security

See SECURITY.md for security policy and reporting vulnerabilities.

Support

This is a community project provided "as is" with no guaranteed support. See SUPPORT.md for details.