Kinsta MCP

用于Kinsta WordPress托管的Model Context Protocol (MCP)服务器

GitHub
3
试用此 MCP赞助

文档

Kinsta MCP 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.

It supports MCP 2026-07-28 while remaining compatible with earlier stdio clients.

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

VariableRequiredDefaultDescription
KINSTA_API_KEYYes-Kinsta API key (Bearer token)
KINSTA_COMPANY_IDYes-Your Kinsta company ID
KINSTA_API_BASE_URLNohttps://api.kinsta.com/v2API base URL (override for testing)

Features

Tools

The server provides 101 tools covering Kinsta API 1.110.0.

Breaking change in 1.1.0: tool names use underscores instead of dots so they work in clients with strict MCP name validation. For example, kinsta.sites.list is now kinsta_sites_list.

Connectivity

ToolDescription
kinsta_pingCheck server status and API credential configuration

Authentication

ToolDescription
kinsta_auth_validateValidate the current Kinsta API key and return account information if valid

Operations

ToolDescription
kinsta_operations_statusCheck the status of an asynchronous Kinsta operation by operation ID

Company

ToolDescription
kinsta_company_usersList all users in your Kinsta company
kinsta_company_regionsList all available deployment regions for your Kinsta company
kinsta_company_api-keysList all API keys for your Kinsta company
kinsta_company_activity-logsList company activity logs (supports filtering and pagination)
kinsta_company_pluginsList WordPress plugins across all sites (supports search/filter/pagination)
kinsta_company_themesList WordPress themes across all sites (supports search/filter/pagination)

Sites

ToolDescription
kinsta_sites_listList all WordPress sites (optionally include environment details)
kinsta_sites_getGet details for a specific Kinsta site by ID
kinsta_sites_createCreate a new WordPress site (returns an operation_id)
kinsta_sites_create-plainCreate a new plain (empty) site without WordPress installed (returns an operation_id)
kinsta_sites_cloneClone an existing site (returns an operation_id)
kinsta_sites_deleteDelete a Kinsta site permanently (cannot be undone)
kinsta_sites_resetReset a site to a fresh WordPress install (destructive)

Environments

ToolDescription
kinsta_environments_listList all environments for a site
kinsta_environments_createCreate a new WordPress environment for a site (returns an operation_id)
kinsta_environments_create-plainCreate a new plain (empty) environment for a site (returns an operation_id)
kinsta_environments_cloneClone an existing environment (returns an operation_id)
kinsta_environments_pushPush one environment to another (destructive; returns an operation_id)
kinsta_environments_deleteDelete an environment (cannot be undone)
kinsta_environments_php-allocationChange PHP worker allocation for an environment (returns an operation_id)
kinsta_environments_php-allocation-siteChange PHP worker allocation for all environments in a site (returns an operation_id)
kinsta_environments_webrootChange the webroot subfolder for an environment (returns an operation_id)
kinsta_environments_filesList files in an environment's file system
kinsta_environments_redirectsList redirect rules for an environment (supports filtering/pagination)
kinsta_environments_redirects_updateCreate, update, or delete redirect rules for an environment
kinsta_environments_ssh_statusGet SSH/SFTP status for an environment
kinsta_environments_ssh_toggleEnable or disable SSH/SFTP access for an environment
kinsta_environments_ssh_password-accessEnable or disable SSH password-based access
kinsta_environments_ssh_generate-passwordGenerate a new SSH/SFTP password
kinsta_environments_ssh_passwordGet the current SSH/SFTP password
kinsta_environments_ssh_ip-allowlistGet the SSH IP allowlist
kinsta_environments_ssh_ip-allowlist_updateUpdate the SSH IP allowlist
kinsta_environments_ssh_configGet SSH connection configuration for an environment
kinsta_environments_ssh_password-expirationChange SSH password expiration interval
kinsta_environments_wp-cliRun a WP-CLI command on an environment (must start with wp )
kinsta_environments_phpmyadminGet a phpMyAdmin login token for an environment
kinsta_environments_wpa_login-urlCreate a WordPress admin login URL for an existing user
kinsta_environments_wpa_create-userCreate a WordPress admin user
kinsta_environments_wpa_user-existsCheck whether a WordPress admin user exists

Site Tools

ToolDescription
kinsta_tools_clear-cacheClear the server cache for an environment (returns an operation_id)
kinsta_tools_restart-phpRestart PHP for an environment (returns an operation_id)
kinsta_tools_php-versionChange the PHP version for an environment (returns an operation_id)
kinsta_tools_denied-ipsGet the list of denied (blocked) IP addresses for an environment
kinsta_tools_denied-ips_updateUpdate the list of denied (blocked) IP addresses for an environment
kinsta_tools_force-https_getGet the Force HTTPS status for an environment
kinsta_tools_force-https_setSet the Force HTTPS status for an environment
kinsta_tools_search-and-replacePreview or perform a database search and replace

Plugins & Themes

ToolDescription
kinsta_plugins_listList all plugins for an environment
kinsta_plugins_updateUpdate a single plugin (returns an operation_id)
kinsta_plugins_bulk-updateUpdate multiple plugins at once (returns an operation_id)
kinsta_plugins_list-wpList plugins with details from the WordPress.org repository
kinsta_themes_listList all themes for an environment
kinsta_themes_updateUpdate a single theme (returns an operation_id)
kinsta_themes_bulk-updateUpdate multiple themes at once (returns an operation_id)
kinsta_themes_list-wpList themes with details from the WordPress.org repository

Domains

ToolDescription
kinsta_domains_listList all custom domains for an environment
kinsta_domains_addAdd a custom domain to an environment
kinsta_domains_deleteRemove custom domains from an environment
kinsta_domains_verificationGet DNS verification records for a domain
kinsta_domains_set-primarySet the primary domain for an environment

DNS (Kinsta DNS)

ToolDescription
kinsta_dns_domainsList all DNS domains for your company
kinsta_dns_recordsList DNS records for a domain
kinsta_dns_records_createCreate a new DNS record
kinsta_dns_records_updateUpdate an existing DNS record
kinsta_dns_records_deleteDelete a DNS record

Edge Cache & CDN

ToolDescription
kinsta_edge-cache_clearClear the edge cache for an environment (returns an operation_id)
kinsta_edge-cache_toggleEnable or disable edge caching for an environment
kinsta_cdn_clear-cacheClear the CDN cache for an environment (returns an operation_id)
kinsta_cdn_image-optimizationConfigure CDN image optimization settings

SFTP Users

ToolDescription
kinsta_sftp-users_listList additional SFTP/SSH user accounts for an environment
kinsta_sftp-users_toggleEnable or disable additional SFTP/SSH accounts
kinsta_sftp-users_addAdd a new additional SFTP/SSH user account
kinsta_sftp-users_removeRemove an additional SFTP/SSH user account

Backups

ToolDescription
kinsta_backups_listList all backups for an environment
kinsta_backups_downloadableList downloadable backups for an environment
kinsta_backups_createCreate a manual backup (returns an operation_id)
kinsta_backups_restoreRestore an environment from a backup (destructive; returns an operation_id)
kinsta_backups_deleteDelete a backup (cannot be undone)
kinsta_backups_create-downloadableCreate a downloadable backup
kinsta_backups_next-downloadableGet when the next downloadable backup can be created

Analytics

ToolDescription
kinsta_analytics_visitsGet visitor analytics for an environment over a date range
kinsta_analytics_visits-usageGet visitor usage analytics (billable visits)
kinsta_analytics_bandwidthGet bandwidth analytics for an environment over a date range
kinsta_analytics_bandwidth-usageGet bandwidth usage analytics (billable bandwidth)
kinsta_analytics_cdn-bandwidthGet CDN bandwidth analytics for an environment over a date range
kinsta_analytics_cdn-bandwidth-usageGet CDN bandwidth usage analytics (billable CDN bandwidth)
kinsta_analytics_disk-spaceGet disk space usage analytics for an environment
kinsta_analytics_top-countriesGet top visitor countries
kinsta_analytics_top-citiesGet top visitor cities
kinsta_analytics_top-client-ipsGet top client IP addresses
kinsta_analytics_top-asnsGet top autonomous system numbers
kinsta_analytics_top-browsersGet top browsers
kinsta_analytics_top-hostsGet top hosts
kinsta_analytics_top-referrersGet top referrers
kinsta_analytics_top-uasGet top user agents
kinsta_analytics_visits-dispersionGet visit dispersion
kinsta_analytics_response-codesGet response code breakdown

Logs

ToolDescription
kinsta_logs_getGet log file contents for an environment

Resources

The server exposes data as MCP resources:

Static Resources

Resource URIDescription
kinsta://sitesList all WordPress sites in your Kinsta company
kinsta://regionsList available deployment regions

Resource Templates

Resource URIDescription
kinsta://sites/{site_id}Details for a specific site
kinsta://sites/{site_id}/environmentsEnvironments for a specific site

Prompts

The server provides guided prompts for common workflows:

PromptDescription
deploy-siteGuide through creating a new WordPress site on Kinsta
manage-backupsGuide for backup list, create, restore, download, and delete workflows
push-environmentGuide for pushing changes between environments (e.g. staging to live)
setup-domainGuide 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