|
/ Documentation /Developers Documentation/ Enabling the AI (MCP) Integration and Connecting an AI Client

Enabling the AI (MCP) Integration and Connecting an AI Client

SureRank supports the Model Context Protocol (MCP), which lets AI clients such as Claude and Cursor connect directly to a WordPress site and read or update SEO settings, page and term metadata, SEO checks, sitemap configuration, and robots.txt through SureRank. With SureRank Pro active, AI clients can also manage redirections, submit URLs for indexing, and update the news, video, and author sitemap and breadcrumb settings. This document covers turning the integration on and connecting a compatible AI client to it.

What This Integration Does

Once enabled, MCP exposes the following SEO abilities to a connected AI client:

AreaAbilities
ContentList content types, list content items, get/update post SEO, get/update term SEO
Site settingsGet/update global SEO settings, get/update robots.txt, get/update sitemap settings.
AnalysisGet post SEO checks, get term SEO checks

An AI client with these abilities can, for example, audit a batch of posts for missing meta descriptions and update them, adjust sitemap or robots.txt rules, or pull SEO check results for a page, all through natural-language requests to the connected client instead of the SureRank admin screens.

SureRank Pro Abilities

When SureRank Pro is installed and active, the following abilities are added to the same MCP connection. No extra setup is needed beyond the steps in this document, unless an ability notes otherwise below.

Redirections

  • List redirections (surerank/list-redirections): Lists redirection rules, with pagination and search by source or destination URL. Read only.
  • Create redirection (surerank/create-redirection): Creates a redirection rule. If a rule with the same source URLs and query rule already exists, its destination URL is updated instead.
  • Update redirection (surerank/update-redirection): Updates an existing redirection rule. Only the fields provided are changed.
  • Delete redirection (surerank/delete-redirection): Permanently deletes a redirection rule by its ID.

Google Indexing

  • Submit URL for indexing (surerank/submit-url-for-indexing): Requests indexing or re-indexing of up to 100 URLs through the Google Indexing API. Requires Google service account credentials configured in SureRank Pro.
  • Remove URL from index (surerank/remove-url-from-index): Asks Google to remove up to 100 URLs from its index. Works only for pages that return a 404 or 410 status or are set to noindex.
  • Get indexing logs (surerank/get-indexing-logs): Shows the history of Google Indexing API requests, newest first. Read only.
  • Get indexing quota (surerank/get-indexing-quota): Shows the Google Indexing API quota limits, current usage, and remaining capacity. Read only.

IndexNow (Instant Indexing)

  • Submit instant indexing (surerank/submit-instant-indexing): Submits up to 100 URLs to IndexNow-compatible search engines, such as Bing and Yandex. Uses the site’s IndexNow key, so no extra credentials are needed.
  • Get instant indexing logs (surerank/get-instant-indexing-logs): Shows the history of IndexNow submissions, newest first. Read only.

Sitemaps

  • Get / update news sitemap settings (surerank/get-news-sitemap-settings, surerank/update-news-sitemap-settings): Shows or changes the Google News sitemap toggle and the post types it includes.
  • Get / update video sitemap settings (surerank/get-video-sitemap-settings, surerank/update-video-sitemap-settings): Shows or turns the video sitemap on or off.
  • Get / update author sitemap settings (surerank/get-author-sitemap-settings, surerank/update-author-sitemap-settings): Shows or turns the author sitemap on or off.

Breadcrumbs

  • Get / update breadcrumb settings (surerank/get-breadcrumb-settings, surerank/update-breadcrumb-settings): Shows or changes whether breadcrumbs are output and whether parent pages appear in the trail.

With these abilities, an AI client can, for example, add redirects for pages that were moved, submit newly published URLs to IndexNow, or turn on the video sitemap.

Important: Every ability still enforces the manage_options capability check on the WordPress side. Connecting an AI client only works with an account that has Administrator-level permissions.

How to Enable MCP

  1. Go to WordPress Dashboard → SureRank → Tools → MCP.
  2. Turn on Enable MCP.
  3. If the WP MCP Adapter plugin isn’t detected on the site, an inline warning titled “MCP Adapter plugin not detected” appears, explaining that the WP MCP Adapter plugin is required to connect AI clients. Select Download from GitHub, then install it the usual way:
    • Go to Plugins → Add New → Upload Plugin.
    • Upload the downloaded mcp-adapter.zip file.
    • Select Install Now, then Activate.
  4. Return to SureRank → Tools → MCP. The Connect Your AI Client panel appears below the toggle as soon as MCP is enabled, even before the adapter is installed.
  5. Once the adapter is active, the “MCP Adapter plugin not detected” warning disappears, but the panel stays visible either way.
image

Note: Turning Enable MCP off disables SureRank’s abilities and its dedicated MCP server. Other plugins’ abilities and the adapter’s global server are controlled separately.

Connecting an AI Client

The Connect Your AI Client panel generates a ready-to-use connection config. It uses your existing WordPress login and an Application Password. SureRank does not generate a separate API key or token for MCP.

Step 1: Create an Application Password

Select Open Application Passwords in the panel (opens Users → Profile → Application Passwords), and generate a new password.

image

Copy it and keep it saved; it’s only shown once.

Step 2: Choose a Connection Scope

Use the tabs above the generated config:

  • SureRank Only: connects to SureRank’s abilities alone, at https://yoursite.com/wp-json/surerank/v1/mcp.
  • Global: connects to every WordPress ability exposed through the WP MCP Adapter’s default server (including other plugins that register abilities), at https://yoursite.com/wp-json/mcp/mcp-adapter-default-server.

Step 3: Copy the Generated Config

This local configuration uses npx. Install Node.js 20 or newer and confirm node and npx are available to your client. If a desktop client cannot find npx, use its absolute path and configure PATH for that client. ChatGPT connectors are not supported by this Application Password setup. Use the copy icon in the top-right of the code block:

{

  "mcpServers": {

    "yoursite-com-surerank": {

      "command": "npx",

      "args": [ "-y", "@automattic/mcp-wordpress-remote@latest" ],

      "env": {

        "WP_API_URL": "https://yoursite.com/wp-json/surerank/v1/mcp",

        "WP_API_USERNAME": "your-wp-username",

        "WP_API_PASSWORD": "your-application-password"

      }

    }

  }

}

Replace “your-application-password” with the Application Password that you saved from step 1.

Step 4: Add the Config to Your AI Client

ClientConfig file
Claude Code.mcp.json
Claude Desktopclaude_desktop_config.json
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json

If a config file already lists other MCP servers, add this entry alongside them rather than replacing the file. For VS Code, nest the entry under a servers key instead of mcpServers.

Tip: Select the sparkle icon next to the code block to copy a setup prompt instead of raw JSON. It’s written to be pasted into an AI coding assistant (like Claude Code or Cursor) so it can locate the right config file for your OS and client and apply the change for you.

Expected Outcome

After the config is added (and the client restarted, if required), the AI client can list and call SureRank’s MCP tools, for example retrieving a post’s SEO title/description or updating robots.txt rules, using the account whose Application Password was used to connect.

Settings Explained

SettingDescription
Enable MCPWhen off, SureRank abilities and its dedicated MCP server are disabled. Other plugins and the adapter’s global server are not disabled by this switch.
SureRank Only (tab)Generates a config scoped to only SureRank’s SEO abilities.
Global (tab)Generates a config scoped to all abilities exposed by the WP MCP Adapter site-wide.

Notes and Limitations

  • MCP access always uses standard WordPress Application Passwords. There’s no SureRank-specific API key to manage. Revoking access means deleting the Application Password under Users → Profile → Application Passwords.
  • The WP MCP Adapter plugin must stay active for either scope to work, even though SureRank’s toggle is what registers the abilities.
  • All abilities require an Administrator-level account.
  • Copying the config or prompt uses the browser clipboard API, which requires HTTPS (or localhost).
  • SureRank Pro abilities are available only when SureRank Pro is installed and active, and they follow the same Enable MCP toggle as the free abilities.
  • The news, video, and author sitemaps are served only when the main XML sitemap is enabled. The author sitemap also needs author archives enabled.
  • The Google Indexing API supports only pages with JobPosting or BroadcastEvent (inside VideoObject) structured data. Other pages are usually ignored but still use the daily quota of 200 requests. Removal requests use the same quota.
  • Breadcrumb display options such as the separator, the home label, and formats are set by the theme or the breadcrumb shortcode, and cannot be changed through MCP.

Troubleshooting

“MCP Adapter plugin not detected” keeps showing after installing it. Confirm it’s activated under Plugins → Installed Plugins, not just uploaded.

The AI client can’t connect after adding the config. Verify the Application Password (not account password) was used, Enable MCP is on, and the account is an Administrator.

The copy button doesn’t do anything. The admin page likely isn’t served over HTTPS; copy the config manually instead.

Was this doc helpful?
What went wrong?

We don't respond to the article feedback, we use it to improve our support content.

Need help? Contact Support
Table of Contents
Scroll to Top