AI agents (MCP)
Zinn® Chat for AI agents
Your WordPress site is its own MCP server. An AI assistant signs in as a WordPress user with an application password and can do what that user may do with Zinn® Chat — nothing more.
36 actions: 21 free, 15 in Pro.
Developer reference: every action, its REST route and its parameters
Set it up in three steps
Check the switch
You need WordPress 6.9 or later and Zinn® Chat 2.9.0 or later. In the plugin's settings, "Allow AI agents (MCP)" is on unless you turned it off.
Create an application password
In WordPress, open Users, then Profile, and add an application password named after your AI app. Copy it: WordPress shows it once.
Add the site to your AI app
Use your WordPress username, the application password and your site's connection address:
https://example.com/wp-json/zinn-chat/v1/mcp
Configuration for popular AI apps
Every app below talks to your site through the official WordPress proxy, @automattic/mcp-wordpress-remote. Replace the address, username and password with yours.
Claude Desktop
// claude_desktop_config.json
{
"mcpServers": {
"zinn-chat": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}Claude Code
claude mcp add zinn-chat \
-e WP_API_URL=https://example.com/wp-json/zinn-chat/v1/mcp \
-e WP_API_USERNAME=your-username \
-e WP_API_PASSWORD=your-application-password \
-- npx -y @automattic/mcp-wordpress-remote@latestCursor
// .cursor/mcp.json
{
"mcpServers": {
"zinn-chat": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}VS Code
// .vscode/mcp.json — VS Code's key is "servers"
{
"servers": {
"zinn-chat": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}Other apps
Any app that supports MCP servers over standard input and output can use the same command and settings. Apps that only connect to remote HTTP servers can reach the connection address directly with the same username and application password. ChatGPT is the exception for now: it connects to MCP servers only by OAuth sign-in, so it cannot use an application password.
What an AI agent can do
Everything the plugin's own screens can do. Actions marked Pro need a Zinn® Chat Pro licence.
| Action | What it does | Edition |
|---|---|---|
| Answer a ticket | Replies to the customer by email (text), or adds an internal note (note: true); status optionally changes the ticket's status. | Free edition |
| Ask the assistant | Asks the site's AI assistant a question and returns its answer with every source it found. | Free edition |
| Change many tickets at once (Pro) | Changes the status, priority or assignee of up to 100 tickets (ids). Each ticket goes through the same checks as changing it on its own; the result lists each one. | Pro edition |
| Turn a chat into a ticket | Opens a ticket from a chat so it can be answered by email (needs the visitor's email address). | Free edition |
| Close a chat | Ends a chat; the visitor can still ask for the transcript. | Free edition |
| Open a ticket | Opens a ticket on a customer's behalf (their email, a subject and the first message). | Free edition |
| Delete a saved reply (Pro) | Deletes a saved reply. | Pro edition |
| Delete a ticket | Deletes a ticket and its conversation for good (managers only). | Free edition |
| Draft a help article from a ticket (Pro) | Writes a draft knowledge-base article from a solved ticket; it stays a draft until a person publishes it. | Pro edition |
| Draft help articles for unanswered questions (Pro) | Writes draft knowledge-base articles answering the chosen questions (ids); they stay drafts. | Pro edition |
| Fill in a saved reply (Pro) | Returns a saved reply's text with its placeholders filled for one chat or ticket. | Pro edition |
| Read a chat | Returns one chat's messages and visitor details (after: only messages newer than this id). | Free edition |
| Read the support overview | Returns how many tickets are in each status and how many chats are waiting for a person (and their unread messages), and whether the chat, the assistant and tickets are switched on. | Free edition |
| Read the chat settings | Returns every chat setting: the widget, the assistant, people and opening hours, tickets and email, the site index, privacy and spam. | Free edition |
| Read support statistics (Pro) | Returns chat and ticket numbers, response times and ratings for the last N days (days). | Pro edition |
| Read a ticket | Returns one ticket with its whole conversation, status, priority and assignee. | Free edition |
| Hand a chat back to the assistant | Returns a chat to the AI assistant, which answers the visitor from the site's content. | Free edition |
| List saved replies (Pro) | Lists the saved replies agents can insert, with their shortcuts. | Pro edition |
| List live chats | Lists the chats waiting, in progress and recently closed, with who is handling each. | Free edition |
| List what the assistant knows | Lists the content the assistant answers from, with its index status, a page at a time. | Free edition |
| List unanswered questions (Pro) | Lists the questions visitors asked that the knowledge base could not answer. | Pro edition |
| List tickets | Lists support tickets, filtered by status or a search, a page at a time. | Free edition |
| Rebuild the assistant's search index | Rebuilds the search vectors for one item (item_id) or everything (all: true) (managers only). | Free edition |
| Re-read content into the assistant | Re-reads one item (item_id) or everything (all: true) into the assistant's index (managers only). | Free edition |
| Reply in a chat | Sends a message to the visitor (text), or adds an internal note only agents see (note: true). | Free edition |
| Save a saved reply (Pro) | Creates or changes a saved reply (title, shortcut, body, department; id to change one). | Pro edition |
| Write a help article (Pro) | Creates a knowledge-base article, or changes one (id): title, content, excerpt, categories and status (draft, or publish when you may publish). | Pro edition |
| Search the knowledge base (Pro) | Finds help articles to link in a reply (q: the search). | Pro edition |
| Set a conversation's department and tags (Pro) | Sets the department and tags of a chat or ticket (kind: chat or ticket; id). | Pro edition |
| Mark unanswered questions (Pro) | Marks unanswered questions as open, planned or dismissed (ids, status). | Pro edition |
| Set your availability | Marks the signed-in agent available or away for new chats (away: true or false). | Free edition |
| Draft a reply with AI (Pro) | Drafts a reply to a chat or ticket from the site's content; nothing is sent. | Pro edition |
| Summarise a conversation with AI (Pro) | Summarises a chat or ticket in a few lines. | Pro edition |
| Take a chat | Assigns a waiting chat to the signed-in agent, so the visitor talks to a person. | Free edition |
| Change the chat settings | Changes the settings you send (settings: key to value) and keeps the rest. Each value is checked exactly as on the settings screen; get-settings lists the keys. | Free edition |
| Change a ticket | Changes a ticket's status, priority or assignee. | Free edition |
Safe by design
Each action checks the same WordPress permission as the plugin's own screen, for the exact page or post it touches. A subscriber cannot connect at all.
Application passwords can be revoked at any time under Users, Profile, without changing your normal password.
Turn "Allow AI agents (MCP)" off and the actions and the connection address disappear from the site.
Pages an agent changes keep their WordPress revisions, so any change can be undone.
Hosted with Zinn Digital®?
If Zinn Digital® hosts the site, our own MCP server can use these actions for you without an application password: connect your AI app to the Zinn Digital® MCP server and use wordpress_abilities_list and wordpress_ability_run.