AI agents (MCP)
Zinn® SEO 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® SEO — nothing more.
393 actions: 221 free, 172 in Pro.
Developer reference: every action, its REST route and its parameters
The same guide in our knowledge base, with every free action listed
Set it up in three steps
Check the switch
You need WordPress 6.9 or later and Zinn® SEO 0.16.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-seo/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-seo": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-seo/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}Claude Code
claude mcp add zinn-seo \
-e WP_API_URL=https://example.com/wp-json/zinn-seo/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-seo": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-seo/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-seo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-seo/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}Claude and ChatGPT (sign in)
Add the connection address as a custom connector in Claude, or as an app in ChatGPT developer mode. They open your site so you can approve them as a WordPress user, with no application password to copy. Your site needs pretty permalinks.
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.
What an AI agent can do
Everything the plugin's own screens can do. Actions marked Pro need a Zinn® SEO Pro licence.
| Action | What it does | Edition |
|---|---|---|
| Accept the differences | Accepts the differences found as intended. | Free edition |
| Add ideas to the content plan (Pro) | Adds up to 100 ideas to the content plan. Each idea has a working title, and may have a phrase, an angle, a kind, a due date (YYYY-MM-DD), a keyword list, a length in words and a voice. | Pro edition |
| Add an internal link (Pro) | Adds a link from one post (source) to another (target) on the given anchor text. | Pro edition |
| Add one of your other sites (Agency) | Adds another site the owner runs (url, label). Its public posts and pages are read in the background for link suggestions. | Pro edition |
| Move SEO tests on (Pro) | Moves running tests to their next phase when it is due, and returns them. | Pro edition |
| Analyse a page draft | Runs the checks on draft values (content, title, slug, focus keyphrase, SEO title and description …) and returns the results; store true keeps the score. | Free edition |
| Switch on the recommended clean-up | Turns on the clean-up set that is safe for most sites. | Free edition |
| Apply a title or description (Pro) | Sets a page's (post_id) SEO title or description (field) to a value. | Pro edition |
| Ask your SEO data a question (Pro) | Answers a question in plain words from this site's own SEO data (question; history: the conversation so far). | Pro edition |
| Give a keyword list to posts | Gives a keyword list to posts (add: post ids) or takes it off them (remove: post ids). Only posts the person may edit change. | Free edition |
| Start a move from another SEO plugin | Starts copying from a source plugin in the background (source, overwrite). | Free edition |
| Rebuild the link index | Rebuilds the internal link index in the background. | Free edition |
| Index the site for meaning-based links (Pro) | Builds the meaning-based link index in the background. | Pro edition |
| Set one value on every matching page | Sets the same fields on every post or term matching the filters, in the background, as one batch that can be undone. | Free edition |
| Change many redirects | Deletes, enables, disables or groups the redirects with these ids. | Free edition |
| Change SEO fields of many pages | Saves the fields of many posts or terms at once (rows: id and fields). Each row is checked as on the editor screen; every change can be undone as one batch. | Free edition |
| Cancel a scheduled change (Pro) | Cancels one scheduled change of a page. | Pro edition |
| Check every page is indexed | Starts, pauses, resumes or cancels an index check of every page, on credits. | Free edition |
| Check links now (Pro) | Checks every link in the background. | Pro edition |
| Check a draft against its guidelines (Pro) | Scores text (or the saved post) against one post's guidelines: each term marked missing, too few, too many or right, and the heading count. | Pro edition |
| Check a move from another domain | Checks what moving from another domain (from) to this site needs: which old addresses redirect where. | Free edition |
| Compare pages before switching | Compares real pages with both plugins to prove nothing is lost (keep: keep the comparison). | Free edition |
| Check if Google indexed an address | Inspects one address in Search Console (url). | Free edition |
| Check a draft for copied text (Pro) | Checks a post or pasted text for sentences copied from other sites, on the site owner's Zinn® credits (post or text; count: sentences). | Pro edition |
| Check the pages' SEO output | Reads the home page and newest posts and pages again and reports any title, description, canonical, robots or structured data that changed. | Pro edition |
| Check pages are indexed | Checks whether addresses (urls) are in Google's index, on credits. | Free edition |
| Check redirects | Checks every redirect for chains and loops, and (targets) whether targets answer. | Free edition |
| Check server rules (Pro) | Checks draft server rules (text) without saving them. | Pro edition |
| Check the whole site's index | Starts, pauses, resumes or cancels inspecting every page in Search Console. | Free edition |
| Choose the AI model for a task | Chooses the model one AI task (feature: writer, proofread or image) uses (choice, one of the models listed for it; empty goes back to the automatic choice). | Free edition |
| Choose the Google properties | Chooses the Search Console property and Analytics stream this site reports on. | Free edition |
| Clear the missing pages log | Deletes one entry (hash) or every entry (all) of the 404 log. | Free edition |
| Clear the site search log | Deletes one entry (hash) or every entry (all). | Free edition |
| Comment on an SEO task (Agency) | Adds a comment (text) to a task. | Pro edition |
| Mark an SEO task done (Agency) | Marks a task done, or open again with done false. | Pro edition |
| Connect Bing Webmaster Tools | Connects Bing with the site owner's Bing API key (key). The key is never returned. | Free edition |
| Connect Cloudflare (Pro) | Connects Cloudflare with the owner's API token (token). The token is never returned. | Pro edition |
| Connect to support | Connects this site to Zinn Digital® support (name, email, consent). | Free edition |
| Pause, resume or cancel an AI bulk run (Pro) | Controls a running AI job (job, action). | Pro edition |
| Start, pause, resume or cancel a background job | Runs action (start, pause, resume or cancel) on one background job (id). | Free edition |
| Copy from another SEO plugin | Copies a source plugin's data now (source, overwrite). | Free edition |
| Count what a move would copy | Counts what moving from a source plugin would copy (source, overwrite). Nothing changes. | Free edition |
| Add an affiliate link (Pro) | Adds an affiliate link: the destination (target), its short address (slug), a label, the redirect code (301, 302 or 307) and nofollow. | Pro edition |
| Turn questions into an FAQ | Creates an FAQ block draft (items: question and answer; post_id or a new title). | Free edition |
| Make the glossary page (Pro) | Creates a draft page that lists the glossary with its structured data. | Pro edition |
| Create a keyword list | Creates a keyword list from a label, a colour and its phrases. | Free edition |
| Create a redirect | Creates a redirect: source, target, code (301, 302, 307, 308, 410, 451), regex, group, note. | Free edition |
| Make a client report link (Agency) | Creates a private web link a client opens to read their reports, without a WordPress login (label; days until it expires). | Pro edition |
| Create an SEO task (Agency) | Creates a task: title, detail, url, issue, assignee (a user id) and due date. | Pro edition |
| Save a written draft as a post | Saves a reviewed draft as a draft post: draft holds title, excerpt, intro paragraphs, sections (heading and paragraphs), seo_title and seo_desc; options hold post_type, phrase and kwlist. Nothing is published. | Free edition |
| Accept or reject AI redirects (Pro) | Accepts (creates the redirects) or rejects the suggestions with these ids. | Pro edition |
| Accept or reject an AI suggestion | Accepts (optionally with edited fields) or rejects one item's suggestion for a task. | Free edition |
| Delete an affiliate link (Pro) | Deletes one affiliate link; its short address stops redirecting. | Pro edition |
| Delete an idea from the content plan (Pro) | Deletes one idea from the plan; a draft already written from it stays. | Pro edition |
| Delete a keyword list | Deletes one keyword list; the posts it was given to are not changed. | Free edition |
| Delete a redirect | Deletes one redirect. | Free edition |
| Delete an SEO test (Pro) | Deletes a finished test's record. | Pro edition |
| Delete an SEO task (Agency) | Deletes a task and its comments. | Pro edition |
| Switch the Zinn® CDN off | Switches the Zinn® CDN off: the site serves its own files again at once. | Free edition |
| Disconnect Bing | Disconnects Bing Webmaster Tools. | Free edition |
| Disconnect Cloudflare (Pro) | Disconnects Cloudflare and turns the edge features off. | Pro edition |
| Disconnect Google | Disconnects Google Search Console and Analytics from this site. | Free edition |
| Disconnect the Google Docs add-on (Pro) | Revokes the person's Google Docs add-on key: their add-on can no longer send drafts to this site. | Pro edition |
| Disconnect from support | Disconnects this site from support. | Free edition |
| Hide a finding | Hides one finding (id) for some days, or for good. | Free edition |
| Dismiss notices | Dismisses notices (ids, or all). | Free edition |
| Write drafts from planned ideas (Pro) | Writes a draft post for each chosen idea (ids, up to 500) in the background, on the site owner's AI. Nothing is published. | Pro edition |
| Draft a custom block with AI (Pro) | Drafts a custom block from one sentence describing it. | Pro edition |
| Write a page from a brief (Pro) | Creates a draft page from a content brief (brief). | Pro edition |
| Draft a page for a keyword (Pro) | Creates a draft from a keyword row (row), against a competitor (rival), as a post type (type). | Pro edition |
| Draft a page for a search | Creates a draft whose title and focus keyphrase are a phrase visitors searched for. | Free edition |
| Draw social card images (Pro) | Draws a social card image for every post in the background. | Pro edition |
| Switch the Zinn® CDN on | Switches the Zinn® CDN on for this site, a paid Zinn® service on the site owner's account. | Free edition |
| Price an authority check | Says what checking these metrics from this source would cost (metrics, cadence_days). | Free edition |
| Export redirects as server rules (Pro) | Returns the redirects as rules for one server (kind: apache or nginx). | Pro edition |
| Export the SEO settings | Returns this site's settings as a file another site can import. Nothing secret is included. | Free edition |
| Find the business for local tracking (Pro) | Finds the business on the map to track. | Pro edition |
| Find a business on the map | Finds businesses for the local tools (query, location, language, lat, lng). | Free edition |
| Find pages to test (Pro) | Finds pages for a test (search). | Pro edition |
| Fix a broken link (Pro) | Rechecks, ignores, unlinks or replaces (url) one broken link everywhere it appears. | Pro edition |
| Fix an SEO conflict | Applies the fix for one conflict (id). It can be undone. | Free edition |
| Stop crawl waste (Pro) | Turns one crawl budget fix (what) on or off (on). | Pro edition |
| Fix redirect chains | Points every chained redirect straight at its final target. | Free edition |
| Create a picture with AI (Pro) | Draws a picture from a prompt into the media library, with alt text, a caption and a file name, in a size, on the owner's own AI key or Zinn® credits (funding). For a picture still being drawn, ask again with its run. | Pro edition |
| Make pages from a spreadsheet (Agency) | Creates one page per spreadsheet row from the plan, each with its own SEO title and description; thin rows are held back. Undo removes the whole run. | Pro edition |
| Read ad earnings per page | Returns each page's ad earnings in minor units beside its Google clicks and average position. | Pro edition |
| Read the address change state | Returns the site's permalink structure, category and tag bases, and any address change in progress with its redirects. | Free edition |
| Read affiliate clicks (Pro) | Returns clicks per day for one affiliate link (id) or for all of them (id 0), over the last days. | Pro edition |
| Read the affiliate link jobs (Pro) | Returns the progress of the two background jobs: finding affiliate links in every post (index) and checking every destination (check). | Pro edition |
| Read the AI bulk run (Pro) | Returns the running or last AI bulk job and what it did. | Pro edition |
| Read the AI settings | Returns how AI is paid for (the site owner's own key, Zinn® credits or automatic), which tasks are available, and what is waiting for review. | Free edition |
| Read one item's AI suggestions | Returns the suggestions waiting for one post or term. | Free edition |
| Read visits from AI assistants | Returns visits sent by AI assistants per assistant, landing page and day, from Google Analytics and the site's own count. | Pro edition |
| Read the alert channels (Agency) | Lists where SEO alerts go: e-mail and chat channels (Slack, Teams, Discord, Telegram, webhook), each with its state. Secrets are never returned. | Pro edition |
| Read authority scores | Returns the site's domain rating and authority scores from every connected source, and the competitors tracked. | Free edition |
| Read authority history | Returns one metric's history from one source (source, metric; days). | Free edition |
| Read automatic links (Pro) | Returns the rules that turn a phrase into a link everywhere. | Pro edition |
| Read backlinks (Pro) | Returns the site's backlinks, new and lost, and their quality. | Pro edition |
| Read Bing Webmaster Tools | Returns Bing clicks, impressions and crawl state (days). | Free edition |
| Read Bing crawl and link data | Returns the crawl problems Bing reported, Bing's daily crawl figures, the pages with links and, in Pro, the hourly crawl rate. | Free edition |
| Read the links to a page in Bing | Returns the pages Bing knows link to one of this site's pages, with their anchor text. | Free edition |
| List bulk editing filters | Returns the post types, statuses and terms the bulk filters accept. | Free edition |
| Read one business listing (Pro) | Returns one listing's details (service). | Pro edition |
| Read the Zinn® CDN state | Says whether the site's images, CSS and JavaScript are served from the Zinn® CDN, what it costs and what the site is doing now. | Free edition |
| See which changes moved rankings (Pro) | Returns SEO changes beside search performance over time (days, page). | Pro edition |
| Read a check's results | Returns the latest results of one check (tool). | Free edition |
| Read a check run | Returns one run's state and results. | Free edition |
| Read the clean-up settings | Returns every clean-up switch (head tags, feeds, address parameters, search spam, previews) with what it removes. | Free edition |
| Read the comment honeypot | Returns how many spam comments the invisible honeypot stopped and its settings. | Free edition |
| Read the Zinn® account connection | Says whether this site is connected to a Zinn® account, and to which. | Free edition |
| Read a post's content guidelines (Pro) | Returns the content guidelines brought in for one post (pasted from Surfer, Clearscope, MarketMuse, Frase, Semrush or another tool, or fetched from Surfer or Frase) and how well the post follows them. | Pro edition |
| Read the drafting job (Pro) | Returns the progress of the background job writing drafts from the plan. | Pro edition |
| Read crawler visits (Pro) | Lists search and AI crawler visits (bot, search) and crawl budget waste. | Pro edition |
| Read AI crawler rules | Returns which search and AI crawlers may read the site and how often each visited. | Free edition |
| Read the Zinn® credit balance | Returns the credit balance, what each check costs, what is held for running checks and the forecast for scheduled ones. | Free edition |
| Export SEO fields as a spreadsheet (Pro) | Returns what can be exported and a download address for a CSV of every page's SEO fields. | Pro edition |
| Read the site diagnostics | Returns the diagnostics a support ticket would carry: versions, active plugins, limits and recent errors. | Free edition |
| Read the disavow list (Pro) | Returns the domains and addresses to disavow. | Pro edition |
| Make the disavow file (Pro) | Returns the disavow file text for Google. | Pro edition |
| Count duplicates | Counts duplicate titles, descriptions, H1s and keyphrases. | Free edition |
| Read the Cloudflare connection (Pro) | Returns whether Cloudflare is connected and which edge features are on. | Pro edition |
| Read a page's SEO fields | Returns the SEO fields of one post or term (object: post or term; id). | Free edition |
| Read the glossary (Pro) | Returns the glossary terms and their definitions. | Pro edition |
| Read the Google connection | Says whether Google Search Console and Analytics are connected and which properties are used (choices: list the properties to choose from). | Free edition |
| Read the Google Docs connection (Pro) | Says whether the person has a Google Docs add-on key for this site. The key is never returned. | Pro edition |
| Read Google indexing for jobs and live streams | Returns whether job and live stream pages are sent to Google's Indexing API. | Free edition |
| Read the SEO tags of a post or term (Pro) | Returns the tags the plugin prints for one post, term or user (kind, id). | Pro edition |
| Read the SEO tags of an address (Pro) | Returns the exact title, meta, social and structured data tags the plugin prints for an address on this site. | Pro edition |
| Read image SEO | Counts images without alt text or with poor file names, and the running job. | Free edition |
| Read the move from another SEO plugin | Returns which SEO plugins were found, what each holds and where a move stands. | Free edition |
| Read index checks | Returns which pages Google has indexed according to the last checks. | Free edition |
| Read Google index coverage | Returns which pages Google has indexed and why others are not (page). | Free edition |
| Read an index check run | Returns one index run's progress and results. | Free edition |
| Read instant indexing | Returns the IndexNow and Google indexing state and the last submissions. | Free edition |
| Read the indexing log | Returns one page of what each search engine answered for each submitted address, the exclusion rules and which search engines are ready. | Free edition |
| Read the SEO plugin status | Returns the Zinn® SEO version, plan, how many modules and features this build has, whether no-trace mode is on and the next setup step. | Free edition |
| Read a keyword list's coverage | For each phrase of one keyword list: the topic it falls in and its Google impressions and best position over 90 days, or nothing when it still needs a page. | Free edition |
| Read the licence | Returns this site's Zinn® SEO plan, licence state, renewal date and what the plan includes. | Free edition |
| Read link updates | Returns internal links being rewritten after addresses changed. | Free edition |
| Read the internal links summary | Counts orphan pages, dead ends and broken links. | Free edition |
| Read llms.txt | Returns the site's llms.txt (lang: one language) and how it is built. | Free edition |
| Read local rank tracking (Pro) | Returns the business and towns tracked for local rankings. | Pro edition |
| Read thin-page rules | Returns the rules that keep thin pages (empty archives, search, attachments …) out of search, with counts. | Free edition |
| Read the no-trace mode | Says whether no-trace mode (hiding that the site uses an SEO plugin) is on, whether the hosting manages it, and the last switches. | Free edition |
| Read an originality check (Pro) | Returns one originality check's result: each sentence found elsewhere, with where. | Pro edition |
| Read a page's analysis | Returns a page's SEO and readability checks: each check, its result and how to fix it. | Free edition |
| Read a page's target market (Pro) | Returns a page's keyword rows, brief and market. | Pro edition |
| Read the page generator (Agency) | Returns the pages made from a spreadsheet so far and the last run's plan. | Pro edition |
| Read a page's links | Returns the links into and out of one page. | Free edition |
| Read a page's lock (Pro) | Says whether a page's SEO fields are locked, and by whom. | Pro edition |
| Read a page's scheduled changes (Pro) | Lists one page's scheduled SEO changes. | Pro edition |
| Read a page's added structured data (Pro) | Returns the structured data added to one page by hand. | Pro edition |
| Read real page speed | Returns the site's real-user Core Web Vitals (form: phone or desktop). | Free edition |
| Read one post's affiliate links (Pro) | Lists the affiliate links one post or page uses. | Pro edition |
| Read one post's keyword lists | Lists the keyword lists one post or page is given to. | Free edition |
| Read a redirect's conditions (Pro) | Returns the conditions one redirect needs before it runs. | Pro edition |
| Read redirect health | Counts chains, loops and redirects to missing pages. | Free edition |
| Read redirect import sources | Lists the plugins and files redirects can be imported from. | Free edition |
| Read a sent report (Agency) | Returns one report that was made: its figures, summary in plain words and where it went. | Pro edition |
| Read the client report (Agency) | Returns the scheduled client report: name, recipients, language, sections, cadence, brand, and its Google Sheets or Drive destinations. | Pro edition |
| Read a research run | Returns one run's results. | Free edition |
| Read a page's final SEO values | Returns the title, description, robots and canonical a page really gets after templates and defaults (object: post or term). | Free edition |
| Read robots.txt | Returns the site's robots.txt, the owner's own rules and the checks on them. | Free edition |
| Read the SEO permissions of each role (Pro) | Lists every role except administrator with the SEO capabilities it holds, and what each capability allows. | Pro edition |
| Read a page's structured data | Returns the JSON-LD graph a page (post) prints. | Free edition |
| Read custom schema types (Pro) | Returns the site's own structured data templates. | Pro edition |
| Read the marks on score history | Returns the days SEO changes were made and the score alerts that fired, for marking a score's history chart. | Pro edition |
| Read search performance | Returns clicks, impressions, average position and their change (days). | Free edition |
| Read a search report | Returns Search Console rows by page, query, country or device (dim, days). | Free edition |
| Read revenue from search (Pro) | Returns Analytics sessions, conversions and revenue from organic search (days). | Pro edition |
| Read meaning-based link suggestions (Pro) | Returns whether meaning-based link suggestions can run and how much of the site is indexed. | Pro edition |
| Read redirects as server rules (Pro) | Returns the redirects as Apache and Nginx rules, for the fastest redirects. | Pro edition |
| Read .htaccess and Nginx rules (Pro) | Returns the server rules file, its backups and whether it can be edited here. | Pro edition |
| Read a server rules backup (Pro) | Returns one backup's text. | Pro edition |
| Read the SEO settings | Returns every site-wide SEO setting with its schema (type, default and allowed values). | Free edition |
| Read the setup state | Returns each step of the guided setup (done, skipped or to do) and what it detected on the site: the kind of site, other SEO plugins, multilingual plugins, WooCommerce and whether search engines are discouraged. | Free edition |
| Read the sitemaps | Returns the sitemap addresses, what they include and their state. | Free edition |
| Read social card images (Pro) | Says whether the server can draw social card images and the running job. | Pro edition |
| Read social link refresh | Returns whether shared links are refreshed on Facebook, the app id, how many pages wait and the last answers; the app secret is never returned. | Free edition |
| Read the spam page scan | Returns the last scan for spam pages, links and injected content. | Free edition |
| Read a lab speed test | Returns a lab test's results. | Free edition |
| Read submitted sitemaps | Lists the sitemaps Search Console knows, with errors. | Free edition |
| Read the support connection | Says whether this site is connected to Zinn Digital® support, and as whom. | Free edition |
| Read title templates | Returns the title and description templates per post type, taxonomy and archive. | Free edition |
| Read the topical map (Pro) | Returns the site's topics and the gaps between them (days). | Pro edition |
| Read the update checks | Returns each waiting plugin and theme update with its verdict against this site's WordPress and PHP, and the reports of SEO output that changed after updates. | Pro edition |
| Read one page's speed | Returns one address's real-user Core Web Vitals (url, form). | Free edition |
| Read the white label (Agency) | Returns the agency brand shown instead of Zinn® SEO: name, menu, logo, colour, help link, which screens clients see and who counts as agency staff. | Pro edition |
| Read what the writer knows about the site | Returns what the AI writer is told about the site when it suggests ideas: its name, its main categories and its recent post titles. | Free edition |
| Ignore a missing page | Stops listing one missing address. | Free edition |
| Import redirects | Imports redirects from a source plugin or a pasted list (source, text). | Free edition |
| Bring in a real robots.txt file | Imports the rules of a robots.txt file on the server into the editor (import), or moves the file aside (move). | Free edition |
| Read another page's structured data (Pro) | Reads the JSON-LD of any public address (url), to copy into a template. | Pro edition |
| Import SEO settings | Imports a settings export from another site (document). With dry_run true (the default) it only lists what would change; with dry_run false it applies all of it, or nothing when a value is refused. | Free edition |
| Inspect an address in Google | Asks Google's URL inspection whether an address is indexed and why (url). | Free edition |
| List the posts using an affiliate link (Pro) | Lists the posts and pages that use one affiliate link (after: keyset). | Pro edition |
| List affiliate links (Pro) | Lists the site's affiliate links with their short address, destination and state (search; problem: broken or blocked; after: keyset). | Pro edition |
| List the AI models to choose from | Lists the current models of the connected AI providers that one AI task (feature) can use, and the model chosen for it now. | Free edition |
| List AI redirect suggestions (Pro) | Lists the redirects AI proposed for missing pages or a site move, waiting for review. | Pro edition |
| List AI suggestions | Lists AI suggestions waiting for review for one task (task; after, limit). | Free edition |
| List the analysis languages | Lists the site's languages and which checks (readability, keyphrase) run in each. | Free edition |
| List the SEO blocks | Lists the SEO blocks (FAQ, how-to, table of contents, breadcrumbs …) with whether each is switched on. | Free edition |
| List broken links (Pro) | Lists links that fail (verdict broken) or are blocked, with the pages they are on. | Pro edition |
| List bulk changes | Lists earlier bulk changes (batches) and the running job. | Free edition |
| List pages for bulk editing | Lists posts or terms with their SEO title, description and robots (filters: type, status, search, missing, robots, term; before, per_page). | Free edition |
| Read business listings (Pro) | Returns the Google Business Profile, Apple and Bing listings and their state. | Pro edition |
| Read Google reviews (Pro) | Lists the Business Profile's reviews (page: next page token). | Pro edition |
| List check alerts (Pro) | Lists alerts from watched checks (ranking drops, lost links, mentions). | Pro edition |
| List pages for index checks | Lists pages with their last index check (search, state; before). | Free edition |
| List the pay-per-use checks | Lists every check (rank, index, AI visibility, backlinks, audit, keywords, content gap, local, mentions) with its price, schedule and last result. | Free edition |
| List SEO conflicts | Lists duplicate tags or settings coming from the theme or other plugins, each with its fix. | Free edition |
| List the content plan (Pro) | Lists the ideas in the content plan with their state (status; after: keyset). | Pro edition |
| List pages that could win more clicks (Pro) | Lists pages with many Google impressions and few clicks, with their queries, for new AI titles. | Pro edition |
| List custom schema blocks (Pro) | Lists the site's own blocks with structured data. | Pro edition |
| List pages losing clicks (Pro) | Lists pages whose clicks are falling, to refresh (days). | Pro edition |
| List duplicate titles and descriptions | Lists pages sharing a title, description, H1 or focus keyphrase (kind; after, per). | Free edition |
| List what the SEO plugin does | Lists every feature this build of the plugin has, with its plan and module. | Free edition |
| Read a page's SEO change history (Pro) | Lists every change to a page's SEO fields: when, who (a person or an AI agent), before and after. | Pro edition |
| List the per-page SEO fields | Lists the SEO fields a post or term can carry (title, description, robots, canonical and those modules add), with their types. | Free edition |
| List what to fix | Lists every SEO problem found on the site, most important first, each with its one-click fix where one exists. | Free edition |
| List differences found | Returns the first differences the comparison found. | Free edition |
| List integrations | Lists the plugins Zinn® SEO works with, which are installed and which integrations are on. | Free edition |
| List the background jobs | Lists the plugin's background jobs with their status and progress. | Free edition |
| List the posts of a keyword list | Lists the posts and pages a keyword list is given to (after: keyset). | Free edition |
| List keyword lists | Lists the site's keyword lists with their phrases and colour (search; limit; after: keyset). | Free edition |
| List orphan and dead-end pages | Lists pages nothing links to (orphan) or that link nowhere (deadend) (type; before, per). | Free edition |
| List your other sites (Agency) | Lists the owner's other sites that link suggestions are drawn from, with how many pages were read from each and when. | Pro edition |
| List locked pages (Pro) | Lists pages whose SEO fields are locked against changes (after: keyset). | Pro edition |
| List brand mentions (Pro) | Lists mentions of the brand and copies of the content (phrase, tone; limit, offset). | Pro edition |
| List missing pages (404s) | Lists addresses visitors and bots asked for that do not exist (kind 404 or bots), with hits (order, search; after, per). | Free edition |
| List the SEO modules | Lists the plugin's feature modules: name, plan, whether each is on, and what it needs. | Free edition |
| List notices | Lists the notices about checks, credits and problems. | Free edition |
| List Zinn® services for this site | Lists the Zinn® services that fix what was found here (hosting, content, links), with prices. | Free edition |
| List Zinn® orders | Lists orders placed through Zinn® from this site, with their state. | Free edition |
| List page SEO scores | Lists pages with their SEO and readability ratings, newest first (type, rating, issue; before, per). | Free edition |
| List redirect conditions (Pro) | Lists what a redirect can depend on: login, role, device, country, language, referrer, time. | Pro edition |
| List redirects | Lists redirects (search, group, code, origin, problem, regex, enabled; before, per). | Free edition |
| List research runs | Lists earlier runs (tool, watch). | Free edition |
| List repeating research | Lists tools set to run again every 1, 7 or 30 days. | Free edition |
| List earlier versions | Lists the earlier Zinn® SEO versions this site can go back to. | Free edition |
| List scheduled SEO changes (Pro) | Lists SEO changes waiting for their date. | Pro edition |
| List structured data builders (Pro) | Lists the structured data types that can be added to a page, with their fields. | Pro edition |
| List a type's properties | Lists a schema.org type's properties (type). | Free edition |
| List search opportunities (Pro) | Lists the biggest search wins available, with what to do. | Pro edition |
| List SEO title tests (Pro) | Lists title and description tests with their results. | Pro edition |
| List what visitors search for | Lists searches made on the site, and those with no results (kind search0). | Free edition |
| List sitemap files | Lists every sitemap file with its address and entry count. | Free edition |
| List almost-ranking searches (Pro) | Lists queries where a page ranks just below the first page (days). | Pro edition |
| List who can take tasks (Agency) | Lists the users a task can be given to. | Pro edition |
| List SEO tasks (Agency) | Lists the team's SEO tasks (status: open, done or all; after: keyset). | Pro edition |
| List research tools | Lists every research tool (SERP, reviews, shopping, Amazon, YouTube, traffic, technology …) with its price in credits. | Free edition |
| List Zinn® services and prices | Returns every Zinn® service that helps this site with its live price, monthly or one-off, where the plugin uses it and what the account already holds. | Free edition |
| Mark alerts read (Pro) | Marks alerts read (ids). | Pro edition |
| Open a support ticket | Files a support ticket (subject, message, kind, email), with this site's diagnostics when the administrator agreed. It never creates a login or sends one. | Free edition |
| Optimise this site | A guided run: the agent audits the site, proposes a plan, tries every change first, applies what you agree to as undoable changes, and reports what it did. | Pro edition |
| Post a Business Profile update (Pro) | Publishes an update (summary), optionally linking a post (post_id). | Pro edition |
| Preview an address change | Shows how post, category and tag addresses would change with a new permalink structure (structure, category_base, tag_base), page by page (after, per). Nothing changes. | Free edition |
| Preview pages from a spreadsheet (Agency) | Reads a spreadsheet (csv text or a Google Sheets url) and a plan (template page, title and description patterns) and shows the pages it would make, with the rows it would hold back. Nothing is created. | Pro edition |
| Preview an image fix | Shows what an image action (action) would write on a sample of images. Nothing changes. | Free edition |
| Preview a redirect import | Shows what importing from a source (source; text for a pasted list) would add. Nothing changes. | Free edition |
| Preview robots.txt | Shows the whole robots.txt and its checks with draft rules (custom). Nothing changes. | Free edition |
| Preview a social card (Pro) | Draws one post's card with draft settings (post, settings). | Pro edition |
| Preview a title template | Renders a draft template (key, title, desc, sep) on a real example. | Free edition |
| Check spelling, grammar and tone | Checks a post (post) or text for spelling and grammar mistakes, and its tone, in a language. Nothing changes. | Free edition |
| Empty the Zinn® CDN cache | Empties the CDN's cache so visitors get the site's current files. | Free edition |
| Rewrite links to a changed address | Rewrites every internal link from one address (old) to another (new) in the background. | Free edition |
| Price an originality check (Pro) | Says what checking a text for copies on other sites costs in Zinn® credits, for a number of sentences (count). | Pro edition |
| Price a research tool run | Says what running a tool (tool) with these values (params) would cost. Nothing is spent. | Free edition |
| Read your other sites again (Agency) | Reads every listed site's public posts and pages again, in the background. | Pro edition |
| Rebuild the redirect index | Rebuilds the fast lookup index of redirects. | Free edition |
| Rebuild the sitemaps | Rebuilds every sitemap in the background. | Free edition |
| Consent to support diagnostics | Records the administrator's consent to send diagnostics with support tickets. | Free edition |
| Redirect a missing page | Creates a redirect from a missing address (address) to a page (target, code). | Free edition |
| Rebuild llms.txt | Rebuilds llms.txt and llms-full.txt now. | Free edition |
| Refresh shared links now | Asks Facebook to read these pages of this site again so their shared card shows the latest title, text and image. | Free edition |
| Remove a data account key | Deletes the stored key for one source. | Free edition |
| Remove a post's content guidelines (Pro) | Removes the guidelines brought in for one post. | Pro edition |
| Remove one of your other sites (Agency) | Removes one site and the pages read from it. | Pro edition |
| Stop copying reports to a sheet (Agency) | Disconnects one Google Sheets or Drive destination. Reports already written stay there. | Pro edition |
| Reply to a Google review (Pro) | Posts a public reply (text) to one review (id). | Pro edition |
| Research a search on Bing | Returns weekly Bing impressions for one search in a country and language. | Free edition |
| Find keywords worth writing for (Pro) | Finds keywords for a seed (seed, country, language), on credits. | Pro edition |
| Undo an SEO change (Pro) | Puts back the value one history row replaced. | Pro edition |
| Show hidden findings again | Brings back every hidden finding. | Free edition |
| Put back a server rules backup (Pro) | Restores one backup (backup) of the server rules. | Pro edition |
| Send failed pages again | Sends failed submissions again, each to the search engine it failed on; with no ids every failed row is sent. | Free edition |
| Revoke a client report link (Agency) | Turns one client report link off at once. | Pro edition |
| Rewrite a page for a query with AI (Pro) | Writes a new title and description for a page (post_id) aimed at a query. | Pro edition |
| Write SEO text with AI | Runs an AI task (task: e.g. titles, descriptions, alt text) for the given items (ids, options). Results wait as suggestions for a person to accept. Uses the site owner's key or Zinn® credits. | Free edition |
| Check authority now | Checks one source now (with the owner's own key, or on Zinn® credits). | Free edition |
| Run a check now | Runs one check (tool: rank, index, ai, links, audit, keywords, gap …) on the site owner's Zinn® credits (seed, page_url where the check takes one). Each check's price is in the list of checks. | Free edition |
| Run a Cloudflare action (Pro) | Runs one edge action (what): purge, deploy the redirects or the crawler rules. | Pro edition |
| Run a fix | Runs one finding's fix (action, as listed). | Free edition |
| Fix image alt text | Runs an image action (action) on every image in the background. | Free edition |
| Make the client report now (Agency) | Makes the client report now and, with send_email true, e-mails it to the recipients. | Pro edition |
| Run a research tool | Runs a tool (tool) with its values (params) on the site owner's Zinn® credits and returns the run. | Free edition |
| Run a lab speed test | Runs a Lighthouse test of one address (url). | Free edition |
| Scan for SEO conflicts | Reads real pages to find what the theme and other plugins print twice. | Free edition |
| Find duplicates | Rebuilds the duplicate index in the background. | Free edition |
| Scan for spam pages | Scans the site's content for spam pages and injected links. | Free edition |
| Schedule an SEO change (Pro) | Changes a page's SEO fields (fields) at a date (at), optionally changing them back later (revert_at), with a note. | Pro edition |
| Schedule a check | Turns a check's repeat schedule on or off (on). | Free edition |
| Score every page | Starts a background job that scores every page, so lists and reports are complete. | Free edition |
| Score headlines | Scores one or more headlines (titles) for clicks, in a language, with what would make each one stronger. | Free edition |
| Search domain names | Checks which domain names are free and their prices (query). | Free edition |
| Search towns (Pro) | Finds towns and areas in a country (country, q). | Pro edition |
| Search a Zinn® service's listings | Lists what one service offers (offer, product; q, max_price_minor). | Free edition |
| Search schema.org types | Finds schema.org types by name (q). | Free edition |
| Count the work done for the report (Agency) | Sends the counts of SEO changes made on this site since the last report (no content) so the report can show the work done. | Pro edition |
| Choose how AI is paid for | Sets funding: byo (the site owner's own AI key), credits (Zinn® credits) or auto. | Free edition |
| Set the competitors to track (Pro) | Sets the competitor domains whose authority is tracked beside this site's. | Pro edition |
| Set what an authority source checks | Chooses the metrics and how often one source is checked (metrics, cadence_days, on). | Free edition |
| Add your own data account key | Stores the site owner's own API key for a source (key; plus login where the source needs one). The key is never returned. | Free edition |
| Set Bing's crawl rate | Saves how fast Bing crawls this site, hour by hour from 1 (slowest) to 10 (fastest). | Free edition |
| Set what a check tracks | Sets the keywords, pages or competitors a check tracks (items). | Free edition |
| Bring in content guidelines for a post (Pro) | Brings in guidelines for one post: pasted text with its source, or a report (ref) fetched from Surfer or Frase (tool) with the owner's key, in a language. | Pro edition |
| Mark a page to refresh or write (Pro) | Marks a page (page) to refresh or write (kind), done or not, with a note. | Pro edition |
| Add a content tool key (Pro) | Stores the site owner's own API key for a content tool (key). The key is never returned. | Pro edition |
| Record crawler visits (Pro) | Turns crawler logging on or off (on), with a sample rate (sample). | Pro edition |
| Learn the terms top pages use (Pro) | Reads reference pages (urls) and stores the terms a page about the same topic is expected to cover. | Pro edition |
| Send job and live stream pages to Google | Turns the Indexing API on or off (on) for these post types (types). | Free edition |
| Set the pages kept out of indexing | Saves the wildcard rules that keep matching pages out of automatic submission to search engines. | Free edition |
| Turn an integration on or off | Switches one integration (id) on or off (on). | Free edition |
| Set up local rank tracking (Pro) | Sets the business, keywords and towns for local rankings. | Pro edition |
| Set the phrases to watch (Pro) | Sets the brand phrases watched for mentions (phrases). | Pro edition |
| Switch an SEO module on or off | Switches one module (id) on or off (enabled). | Free edition |
| Switch no-trace mode | Turns no-trace mode on or off (enabled). Run it with dry_run true first: it lists every address that would change, which search engines must be told about. | Free edition |
| Tell Zinn® where an order goes | Gives an order the address of the page it is for (url). | Free edition |
| Set a page's target market (Pro) | Sets a page's country, language and phrase for keyword research. | Pro edition |
| Lock or unlock a page (Pro) | Locks (locked true) or unlocks a page's SEO fields. | Pro edition |
| Set a page's structured data (Pro) | Replaces the structured data added to one page (types: type and field values). | Pro edition |
| Set one post's keyword lists | Replaces the keyword lists one post or page is given to (lists: list ids). | Free edition |
| Add a proofreading service key | Stores the site owner's own key for the proofreading service (key). The key is never returned. | Free edition |
| Set a redirect's conditions (Pro) | Sets when one redirect runs (match: all or any; rules: condition, operator, value). | Pro edition |
| Let search engines index the site, or not | Changes WordPress's own Reading setting (public: true lets search engines index the site). Administrators only. | Free edition |
| Change the site's addresses safely | Changes the permalink structure and bases, with a 301 redirect from every old address to its new one, so no ranking or link is lost. | Free edition |
| Start an affiliate link job (Pro) | Starts finding affiliate links in every post (job: index) or checking that every destination still answers (job: check), in the background. | Pro edition |
| Write SEO text for many pages with AI (Pro) | Starts an AI bulk job (task) over post types (types), only where text is missing (missing), with a dry run or straight acceptance (accept). | Pro edition |
| Start an SEO title test (Pro) | Starts a test of new titles or descriptions on pages (name, pages, phases, hours, keep). | Pro edition |
| Start the free Pro trial | Starts the 14-day Zinn® SEO Pro trial for this site (no payment needed). | Free edition |
| Stop a move | Stops a running copy or comparison. | Free edition |
| Stop local rank tracking (Pro) | Stops tracking local rankings. | Pro edition |
| Stop repeating research | Stops a repeating run. | Free edition |
| Stop an SEO test (Pro) | Stops a test and keeps version A or B (keep). | Pro edition |
| Send pages to search engines | Sends this site's addresses to IndexNow, Bing's URL API or Google's Indexing API (job and livestream pages only); each answer is logged. | Free edition |
| Submit the sitemaps | Submits the site's sitemaps to Search Console. | Free edition |
| Submit to Bing | Submits the sitemaps and recent addresses to Bing. | Free edition |
| Ask search engines to index addresses | Sends addresses (urls) to IndexNow and, where allowed, Google. | Free edition |
| Suggest redirects with AI (Pro) | Matches missing addresses (kind notfound) or an old site's addresses (kind move: sitemap or addresses) to the best page here. | Pro edition |
| Suggest internal links | Suggests pages a page (or its draft content) should link to, with anchor text. | Free edition |
| Suggest links to your other sites (Agency) | Suggests pages on the owner's other sites one post could link to, with the words in the post to link from. | Pro edition |
| Suggest links by meaning (Pro) | Suggests pages close in meaning to one page (or its draft content). | Pro edition |
| Switch off the old SEO plugin | Deactivates the old SEO plugin after a clean comparison. It can be undone. | Free edition |
| Fetch new notices | Fetches new notices from the Zinn® account now. | Free edition |
| Copy the report to its sheet now (Agency) | Writes the latest report into its connected Google Sheet or Drive folder now. | Pro edition |
| Send a test alert (Agency) | Sends a test message to one channel (index) and says whether it arrived. | Pro edition |
| Test an address | Says which redirect an address (url) meets and where it ends. | Free edition |
| Test robots.txt | Says whether a crawler (agent) may fetch an address (url), with the saved or draft rules. | Free edition |
| Track a keyword list's rankings | Adds every phrase of one keyword list to the phrases whose rankings are tracked (a paid check on the site owner's Zinn® credits); none already tracked is lost. | Free edition |
| Track keywords (Pro) | Adds keyword rows (rows) to rank tracking. | Pro edition |
| Undo a bulk change | Puts back every value one batch changed. | Free edition |
| Undo a conflict fix | Puts back what one conflict fix changed (id). | Free edition |
| Undo the last page run (Agency) | Moves every page the last spreadsheet run made to the trash. | Pro edition |
| Undo a move | Puts back the values the move overwrote and switches the old plugin on again. | Free edition |
| Change an affiliate link (Pro) | Changes one affiliate link's destination, short address, label, redirect code or nofollow. | Pro edition |
| Change the alert channels (Agency) | Replaces the alert channels (channels: type, url or chat, label, on, important_only) and the e-mail switch (email). | Pro edition |
| Change automatic links (Pro) | Replaces the automatic link rules (rules: phrase, target, limits). | Pro edition |
| Change the site's check profile | Changes the brand, category, market and how often scheduled checks run (cadence_days). | Free edition |
| Change an idea in the content plan (Pro) | Changes one idea's working title, phrase, angle, kind, due date, keyword list, length or voice. | Pro edition |
| Change custom schema blocks (Pro) | Replaces the site's own blocks (blocks: name, fields, schema type and mapping). | Pro edition |
| Change the disavow list (Pro) | Replaces the domains and addresses to disavow (domains, urls). | Pro edition |
| Change a page's SEO fields | Changes the SEO fields you send (fields: name to value) of one post or term; an empty value clears a field. Nothing is stored when one value is refused. | Free edition |
| Change the glossary (Pro) | Replaces the glossary terms (terms: term and definition). | Pro edition |
| Change a keyword list | Changes one keyword list's label, colour or phrases. | Free edition |
| Change a redirect | Changes one redirect's source, target, code, group, note or whether it is on. | Free edition |
| Change the client report (Agency) | Changes the scheduled client report (name, recipients, locale, sections, contact_name, cadence, send_email, narrative, active) and its brand. | Pro edition |
| Change repeating research | Changes a repeating run (active, cadence_days, params). | Free edition |
| Change robots.txt | Stores the owner's own robots.txt rules (custom). | Free edition |
| Change a role's SEO permissions (Pro) | Gives or takes SEO capabilities (caps: capability to true or false) of one role (role). Administrators only; the administrator role is never changed. | Pro edition |
| Change custom schema types (Pro) | Replaces the site's own structured data templates (templates). | Pro edition |
| Change .htaccess rules (Pro) | Saves new server rules (text) after a syntax check and a backup; the site is tested at once and the backup put back if it stops answering. accept_warnings saves despite warnings. | Pro edition |
| Change the SEO settings | Changes the settings you send (settings: key to value) and keeps the rest. Every value is checked as on the settings screen; nothing is stored when one is refused. The no-trace switch has its own tool. | Free edition |
| Change an SEO task (Agency) | Changes a task's title, detail, url, assignee or due date. | Pro edition |
| Change the white label (Agency) | Changes the agency brand (enabled, name, menu, description, author, author_url, help_url, logo_id, colour, hide_zinn) and the client view (client_screens, client_edit, agency_users). | Pro edition |
| Send a redirect list | Keeps a CSV or .htaccess list of redirects (content) for the import. | Free edition |
| Validate structured data | Validates a page's graph (post) or pasted JSON-LD (json) against schema.org and Google's rich result rules. | Free edition |
| Watch a page for copies (Pro) | Watches one page (post) for copies of its content on other sites, on the site owner's Zinn® credits. | Pro edition |
| Repeat a research tool | Runs a tool (tool, params) again every 1, 7 or 30 days (every), on credits. | Free edition |
| Plan a page with an AI brief (Pro) | Writes a content brief for a topic (step write), then a draft from it (step draft, with brief and post type). | Pro edition |
| Write a title that wins more clicks (Pro) | Writes a new title and description for a page (post_id) from its search queries (step write), or starts a test of them (step test). | Pro edition |
| Answer questions with AI (Pro) | Writes answers to questions (questions) people ask about a phrase (phrase). | Pro edition |
| Draft replies to reviews with AI (Pro) | Drafts replies to reviews (reviews) in the business's voice (business). | Pro edition |
| Write social sharing text with AI (Pro) | Writes the Facebook and X title and description of one post. | Pro 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.