Use AI clients like Claude and Cursor to add Kit Forms to your WordPress content and change your website's Kit settings for you.
MCP (Model Context Protocol) is a standard that lets AI clients connect to other software and perform tasks in it.
The Kit plugin includes an MCP server, and once you use it to connect an AI client to your WordPress website, you can ask your client to do things like "Add my newsletter signup form to the bottom of my latest blog post," and it will make the change for you.
NOTE: The MCP server is currently in beta. We'd love to hear your feedback.
This article covers:
Before you start
You'll need:
A paid Kit plan. The MCP server isn't available on the Kit Free plan.
The Kit plugin installed on your WordPress website and connected to your Kit account. If you haven't done this yet, set up the Kit plugin on your WordPress website first.
An AI client that supports MCP, like Claude Desktop, Claude Code, or Cursor.
A WordPress user account with administrator access, as you'll create an Application Password from it.
NOTE: Your website must be publicly reachable over the internet for an AI client to connect to it. A local development site, or a site behind a password or firewall, won't be reachable.
Enable the MCP server
Click Settings on your WordPress sidebar > Kit.
Click the MCP tab.
Select Enable MCP Server.
Click Save Changes.
Your MCP server URL is displayed below the setting. It'll look like this:
https://yourwebsite.com/wp-json/kit/mcp/v1
You'll need this URL, along with an Application Password, to connect your AI client.
Create an Application Password
An Application Password lets your AI client sign in to your WordPress website without you sharing your WordPress password. It can be revoked anytime and works only for the MCP server.
On the MCP tab, click Create Application Password.
WordPress will ask you to authorize an application called Kit WordPress Plugin: MCP Server. Click Yes, I approve of this connection.
You'll be returned to the MCP tab, where your Authorization Header is displayed. It begins with "Basic," followed by a long string of characters.
Copy the Authorization Header and keep it somewhere safe.
NOTE: Your Authorization Header is displayed only once. If you lose it, click Revoke Application Password and create a new one.
Connect your AI client
The MCP tab displays ready-to-use configuration for the most common AI clients, with your website's server URL and Authorization Header already filled in. Copy the configuration for your client from that screen, rather than typing it out.
Use the relevant instructions for your AI client:
ChatGPT desktop app
ChatGPT desktop app
In the ChatGPT desktop app, navigate to Settings > Integrations > Plugins.
Click Add > Add MCP server.
On the Connect to a custom MCP screen, enter this information:
Name: Kit WordPress
Type: Streamable HTTP
Headers: "Authorization" and "Basic YOUR_AUTHORIZATION_HEADER"
Click Save.
Confirm the server is displayed and the toggle is enabled.
Restart the ChatGPT desktop app. Then, start a new chat to confirm the MCP server is connected. For example, by prompting ChatGPT to “List the available tools for the Kit WordPress Plugin MCP Server.”
Claude desktop app
Claude desktop app
Add the configuration displayed on the MCP tab to your claude_desktop_config.json file, then restart Claude Desktop.
You'll find the file at:
For macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
For Windows: %APPDATA%\Claude\claude_desktop_config.json
The configuration looks like this:
{
"mcpServers": {
"kit-wordpress": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://yourwebsite.com/wp-json/kit/mcp/v1",
"--header",
"Authorization: Basic YOUR_AUTHORIZATION_HEADER"
]
}
}
}
Claude Code
Claude Code
Run the command displayed on the MCP tab in your terminal:
claude mcp add --transport http kit-wordpress https://yourwebsite.com/wp-json/kit/mcp/v1 --header "Authorization: Basic YOUR_AUTHORIZATION_HEADER"
Cursor
Cursor
Add the configuration displayed on the MCP tab to your ~/.cursor/mcp.json file, then restart Cursor.
The configuration looks like this:
{
"mcpServers": {
"kit-wordpress": {
"url": "https://yourwebsite.com/wp-json/kit/mcp/v1",
"headers": {
"Authorization": "Basic YOUR_AUTHORIZATION_HEADER"
}
}
}
}
Other clients
Other clients
For any other MCP client, provide it with:
Server URL: Your MCP server URL, displayed on the MCP tab.
Authorization header: Basic followed by your Authorization Header, displayed on the MCP tab.
What you can ask your AI client to do
Once connected, your AI client can look up your Kit account's content, add Kit elements to your posts and pages, and read and change your Kit settings.
You don't need to know the exact names of the actions or tools used—describe what you want in your own words, and your AI client will work out which ones to use.
Look up your Kit account's content
Your AI client can find a Form, Landing Page, Product, or Tag when you refer to it by name, so you don't have to look up an ID.
What your AI client can do | What to ask your AI client |
Lists your Kit Forms, with each Form's format (inline, modal, slide in or sticky bar) | "What Kit Forms do I have?" |
Lists your Kit Landing Pages | "List my Kit Landing Pages" |
Lists your Kit Products | "What products do I have in Kit?" |
Lists your Kit Tags | "Show me my Kit Tags" |
NOTE: Your AI client reads the Forms, Landing Pages, Products, and Tags the plugin has already retrieved from your Kit account. The client can't create or edit them—you'll still do that in Kit.
Add Kit content to your posts and pages
Your AI client can add, list, change, and remove four Kit elements—Forms, Form Triggers, Products, and Broadcasts—within the content of a post, page, or custom post type.
Each works in the same way, and each supports the same options you'd see in the block's settings in the WordPress editor.
NOTE: When adding an element, you can tell your AI client where that element should go—at the end of the content, at the start, or at a specific position.
Kit Form
Displays one of your Kit Forms within your content.
What your AI client can do | What to ask your AI client |
Add a Form to the content | "Add my newsletter form to the end of my About page" |
List the Forms already in the content | "Which Kit Forms are on my About page?" |
Change a Form already in the content | "Change the Form on my About page to my product waitlist form" |
Remove a Form from the content | "Remove the Kit Form from my About page" |
You can set: the Form to display.
Kit Form Trigger
Displays a button that opens one of your modal, slide in or sticky bar Forms.
What your AI client can do | What to ask your AI client |
Add a Form Trigger button to the content | "Add a button on my Pricing page that opens my newsletter modal form" |
List the Form Trigger buttons already in the content | "Are there any Kit form buttons on my Pricing page?" |
Change a Form Trigger button already in the content | "Change the button text on my Pricing page to 'Join the list'" |
Remove a Form Trigger button from the content | "Remove the Kit Form button from my Pricing page" |
You can set: the Form, Button Text, Background color, and Text color.
Kit Product
Displays a button that opens one of your Kit Products for purchase.
What your AI client can do | What to ask your AI client |
Add a Product button to the content | "Add a buy button for my ebook to the bottom of my Books page" |
List the Product buttons already in the content | "What Kit products are on my Books page?" |
Change a Product button already in the content | "Apply the discount code LAUNCH20 to the product button on my Books page" |
Remove a Product button from the content | "Remove the Kit product button from my Books page" |
You can set: the Product, Button Text, Discount Code, Load checkout step, Disable modal on mobile, Background color, and Text color.
Kit Broadcasts
Displays a list of your Kit Broadcasts (your published email newsletters).
What your AI client can do | What to ask your AI client |
Add a Broadcasts list to the content | "Add a list of my newsletters to my Archive page" |
List the Broadcasts lists already in the content | "Is there a broadcasts list on my Archive page?" |
Change a Broadcasts list already in the content | "Show 20 newsletters on my Archive page instead of 10, in a grid" |
Remove a Broadcasts list from the content | "Remove the newsletter list from my Archive page" |
You can set: Display as grid, Display order, Date format, Display images, Display descriptions, Display read more links, Read more label, Number of posts, Display pagination, Newer posts label, Older posts label, Link color, Background color, and Text color.
Change a post or page's Kit settings
These are the same settings you'll find in the Kit section when editing a post, page, or custom post type.
What your AI client can do | What to ask your AI client |
Show a post or page's current Kit settings | "What Kit settings does my About page use?" |
Change a post or page's Kit settings | "Set my About page to use my newsletter form" |
Your AI client can read and change:
Form: The Form to display for the post. The AI client can also set the post to use the plugin's default Form for that post type, or to display no Form at all.
Landing Page: A Kit Landing Page to display instead of the post's content.
Tag: A Kit Tag to apply when a Kit subscriber views the post.
Member Content: Restricts the post's content to subscribers of a Kit Form, Tag, or Product.
Change a category's Kit settings
What your AI client can do | What to ask your AI client |
Show a category's current Kit settings | "What form is set on my Recipes category?" |
Change a category's Kit settings | "Use my newsletter form on all posts in my Recipes category" |
Your AI client can read and change the category's Form, as well as the Form Position used on the category archive page.
Change the Kit plugin's settings
Your AI client can read and change the plugin's General, Broadcasts, and Member Content settings.
What your AI client can do | What to ask your AI client |
Show the plugin's current settings | "What's my default Kit Form for posts?" |
Change the plugin's settings | "Set my default form for posts to my newsletter form, displayed after the content" |
NOTE: Changing your plugin settings affects your whole website. It's worth asking your AI client to tell you what it's about to change before it makes the change.
General settings
Every setting on the General tab is available, apart from your Kit account connection itself:
Default Forms: The default Form for each post type—pages, posts, and any public custom post types on your site.
Form Positions: Where the default Form displays for each post type—before the content, after the content, before and after the content, or after a specific element.
Form Position Element: When positioning after a specific element, which element to use (paragraph, heading, or image) and which occurrence of it.
Site Wide Form: The non-inline Forms (modal, slide in, and sticky bar) to display across your whole site.
Honor "None" setting: Whether a page or post set to "None" suppresses the site-wide non-inline Form.
Limit display: Whether non-inline Forms display only once per visitor session.
reCAPTCHA Site Key and Minimum Score: Your Google reCAPTCHA v3 spam protection settings.
Advanced: Debug logging, disabling the plugin's JavaScript, disabling the plugin's CSS, hiding the "Add New" button for Landing Pages and Member Content, and anonymous usage tracking.
NOTE: Your Kit account connection—your access token, refresh token, API key, API secret, and reCAPTCHA secret key—is deliberately hidden from AI clients, and it can't be read or changed over MCP. Connect and disconnect your Kit account on the General tab instead.
Broadcasts settings
Every setting on the Broadcasts tab is available:
Enable: Whether Broadcasts are automatically imported to WordPress posts.
Author: The WordPress user set as the author of imported posts.
Status: The status given to imported posts—published, draft, pending review, or private.
Category: The WordPress category assigned to imported posts.
Include Thumbnail: Whether a Broadcast's thumbnail is imported as the post's featured image.
Import Images: Whether images in a Broadcast are imported into your WordPress media library.
Earliest Date: The earliest Broadcast date to import from.
Enable Export: Whether WordPress posts can be exported to Kit as Broadcasts.
Disable Styles: Whether the plugin's Broadcast styles are disabled.
Member Content settings
Every setting on the Member Content tab is available, covering both the Form and Tag restriction methods, and the whole email verification flow:
Permit Search Engine Crawlers: Whether search engines can index restricted content.
Require Login (Tags): Whether subscribers must authenticate before accessing tag-restricted content.
Form restriction text: The text shown when content is restricted to a Form's subscribers.
Tag restriction text: The heading, text, and no-access text shown when content is restricted to a Tag's subscribers.
Subscribe Button Label: The label on the subscribe button.
Email verification: The heading, description, text, button label, and the "check your email" heading and text used when a subscriber verifies their email address.
CSS Classes: Additional CSS classes applied to the restricted content container.
Form Entries
Form Entries aren't available over MCP. This means your AI client can't read, export, or delete the entries submitted through your Form Builder forms.
View Form Entries at Settings > Kit > Form Entries instead.
What your AI client can and cannot access
Your AI client connects as the WordPress user who created the Application Password, and it can do only what that user can do. WordPress permissions are always checked, so:
To change a post or page, that user must be able to edit that post or page.
To change a category's settings, that user must be able to edit categories.
To change the Kit plugin's settings, that user must be an administrator.
Your AI client cannot see or change your Kit account itself. It can read the Forms, Landing Pages, Products, and Tags that the plugin has already retrieved from your Kit account, but it can't create or edit them—you'll still do that in Kit.
Your AI client also has no access to your subscribers.
The MCP server is available only while Enable MCP Server is checked. Uncheck it, and AI clients can no longer connect, regardless of whether an Application Password exists.
Revoke access
To disconnect an AI client:
Click Settings on your WordPress sidebar > Kit.
Click the MCP tab.
Click Revoke Application Password.
Any AI client using that Application Password will immediately lose access. To reconnect, create a new Application Password and update your AI client's configuration with the new Authorization Header.
To turn the MCP server off completely, uncheck Enable MCP Server and click Save Changes.
Troubleshooting
The MCP tab doesn't appear, or the Enable MCP Server option is unavailable. The MCP server requires a paid Kit plan. Check which plan your connected Kit account is on. If you've recently upgraded to a paid plan, click Refresh on the General tab of the plugin's settings so the plugin picks up your new plan.
My AI client can't connect or reports a 401 error. Your Authorization Header is probably incorrect or has been revoked. Revoke the Application Password, create a new one, and update your AI client's configuration with the new Authorization Header. Remember that the value starts with Basic, followed by a space.
My AI client reports a 404 error. Verify that Enable MCP Server is checked, and that the server URL in your AI client's configuration matches the one displayed on the MCP tab. If your website uses a plugin or server configuration that disables the WordPress REST API, the MCP server won't be reachable.
My AI client connects, but it can't find any Forms. The plugin caches your Kit account's Forms, Landing Pages, Products, and Tags. Click Refresh on the General tab of the plugin's settings, then ask your AI client again.
My AI client says it doesn't have permission. The Application Password belongs to a specific WordPress user, and your AI client can do only what that user can do. If you need it to change plugin settings, create the Application Password from an administrator account.
If you're still having trouble, refer to our general WordPress troubleshooting guide for help or contact Kit support.