Kinsta Server

CI Coverage Status CodeQL OpenSSF Scorecard npm version npm downloads License Node

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

1. Log in to MyKinsta
2. Go to Your name > Company settings > API Keys
3. Click Create API Key
4. Choose an expiration and give the key a name
5. 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

Site Tools

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.

License

MIT © Jacob Hartmann