← All Plugins
v1.4.0 45 Tools OAuth 2.0

Connect My Site to AI – MCP Server for WordPress

Turn your WordPress site into an MCP server. Let Claude, Cursor, and other AI tools read your content, audit your SEO, and manage your site — all through a secure, authenticated connection.

24 free read-only tools. 21 pro write tools. Zero impact on frontend performance.

Download Plugin Get Pro License How It Works ↓ Free vs Pro ↓ Example Prompts ↓
Connect My Site to AI MCP Server connection settings

What Is MCP and Why Does Your WordPress Site Need It?

Model Context Protocol (MCP) is an open standard created by Anthropic — the company behind Claude AI — that lets AI applications connect directly to external tools and data sources. Think of it as a universal adapter between AI and your data.

Without MCP, getting AI to work with your WordPress site means copying and pasting content, manually exporting data, or building custom API integrations. With MCP, the AI tool connects directly to your site and can search your content, audit your SEO, check your site health, and even create or edit posts — all through natural language.

This plugin turns your WordPress site into a fully compliant MCP server. It exposes 45 purpose-built tools that any MCP-compatible AI can call. Authentication is handled via OAuth 2.0 with PKCE — the same security standard used by Google, GitHub, and Slack. No API keys to manage, no webhooks to configure, no code to write.

The free version gives you 24 read-only tools for content search, SEO auditing, media library browsing, and technical health checks. Pro adds 21 write tools — create posts, fix SEO issues, upload images, manage redirects, and handle taxonomies, all through your AI assistant. See all WordPress plugins by Muntaseer Rahman.

How to Connect Your WordPress Site to AI

Three steps. Under two minutes. No coding required.

1
Install the plugin
Download the ZIP and upload it via Plugins → Add New → Upload Plugin in your WordPress admin. Activate it. The plugin works with WordPress 5.0+ and PHP 7.4+.
2
Copy the instructions for your AI
Go to Settings → Connect to AI. Click "Copy Instructions for AI" and paste it into Claude, Cursor, or any MCP-compatible AI. The AI handles the rest — OAuth registration, authorization, and connection setup are fully automatic.
3
Authorize and start using
Your browser will open an authorization page on your WordPress site. Click "Authorize" and you're connected. Ask the AI to search your content, audit your SEO, check your site health, or manage your posts. All 24 free tools are available immediately.

Works With Your Favorite AI Tools

Any AI tool that supports the Model Context Protocol can connect to your WordPress site.

Claude Desktop
Anthropic's desktop app for Mac & Windows
Claude Code
AI-powered CLI tool for developers
Cursor
AI code editor with MCP support
Any MCP Client
Growing ecosystem of MCP-compatible tools

24 Free Read-Only Tools

Search content, audit SEO, browse media, and check site health — no Pro license required.

Content (7 tools)

get_post
Retrieve full content of any post or page by ID or slug — title, content, excerpt, categories, tags, featured image, dates, and author.
search_content
Search your entire site by keyword with filters for post type, category, tag, and status. Returns matching posts with excerpts and URLs.
list_posts
List posts and pages with advanced sorting by date, title, word count, or comment count. Filter by type, status, category, or tag.
list_categories_tags
Get all categories and tags with post counts, descriptions, and hierarchy. See which taxonomy terms are actually being used.
get_site_info
Site name, URL, content counts by status and post type, registered custom post types, and permalink structure at a glance.
get_post_by_url
Look up any post by its URL or permalink. Paste a link, get back the full post data — no need to hunt for the ID.
get_revisions
View the revision history of any post — who changed what and when. Essential before bulk edits or find & replace operations.

SEO Audit (9 tools)

get_internal_links
Map your internal linking structure. See which posts link to which, find posts with no outgoing links, and analyze link equity distribution.
find_orphan_content
Discover pages with zero incoming internal links — invisible to users and search engines. Fix orphan content to improve crawlability.
find_thin_content
Find posts below a word count threshold. Thin content hurts SEO rankings — identify and improve or consolidate low-quality pages.
find_stale_content
Find posts not updated in months. Set any threshold — 6 months, 12 months, 24 months. Stale content signals neglect to Google.
find_missing_seo_elements
Audit for missing featured images, excerpts, alt text, categories, or tags. Returns exactly what each post is missing.
find_duplicate_titles
Detect posts sharing identical titles — a major keyword cannibalization issue. Find and fix before they compete against each other.
analyze_content_structure
Check heading hierarchy, image count, and readability flags for any post. Ensure your content meets on-page SEO best practices.
get_keyword_density
Analyze keyword mentions and density across your content. Find over-optimized or under-optimized pages for any target keyword.
find_broken_media
Scan post content for broken images returning 404 errors. Fix before users see missing image placeholders.

Media Library (3 tools)

search_media
Search your media library by keyword. Returns attachment IDs, URLs, alt text, dimensions — ready to use for featured images or content insertion.
list_media
Browse the full media library with filters for date, MIME type, and unattached items. Find forgotten uploads and unused images.
get_media_for_post
Get every image used in a specific post — featured image and in-content images with attachment IDs, alt text, and a missing alt count.

Technical & Health (5 tools)

get_technical_info
WordPress version, PHP version, server software, active theme, active plugins, memory limit, SSL status, and debug mode — all in one call.
get_site_health
Security audit: outdated WordPress/PHP, debug mode exposure, file editing enabled, default admin username, XML-RPC, plugin updates, and database prefix.
get_content_calendar
Month-by-month publishing frequency and gap analysis. Spot months with no content and plan your editorial calendar.
get_author_stats
Per-author statistics: post count, average word count, categories covered, most recent post, and publishing frequency.
get_acf_fields
List all Advanced Custom Fields (ACF) field groups and fields for any post type. Returns field names, types, keys, and current values.
Download Free Plugin

21 Pro Write Tools

Create, update, merge, find & replace, upload media, manage redirects, and handle taxonomies — all through your AI assistant.

Content Management PRO (9 tools)

create_post
Create new posts, pages, or custom post types as drafts. Set title, content (Gutenberg block format), excerpt, categories, tags, and featured image.
update_post
Edit any post — title, slug, content, excerpt, status, categories, tags, featured image, and custom fields. Only fields you specify are changed.
trash_post
Move posts to trash safely. Never permanently deletes — everything can be restored from the WordPress admin trash.
restore_from_trash
Undo a trash operation. Restore any trashed post back to draft, pending, or published status.
bulk_update_status
Change the status of up to 50 posts at once. Publish drafts, unpublish posts, or trash content in bulk.
duplicate_post
Clone any post as a new draft — copies content, excerpt, categories, tags, featured image, and custom fields.
merge_posts
Combine thin or duplicate posts into one. Keeps the primary post, appends content from others, merges taxonomy terms, and trashes the sources.
schedule_post
Set a future publish date on any post. WordPress automatically publishes it at the scheduled time.
clone_post_as_template
Duplicate a post's structure — categories, tags, meta, featured image — without the content. Start a new post with the same format instantly.

SEO Fix Tools PRO (7 tools)

update_seo_elements
Batch-fix missing SEO elements: set excerpts, add categories, add tags, set featured images — all on one post in one call.
add_internal_links
Insert a "Related Posts" section with internal links into any post. Provide anchor text and target post IDs — links are built automatically.
update_post_meta
Set custom fields, featured images, or any post meta. Works with ACF fields, SEO plugin meta (Yoast, RankMath), and custom data.
find_and_replace
Search and replace text across your entire site. Defaults to dry run — preview all changes before applying. Maximum 100 posts per call.
bulk_update_meta
Set the same meta field value on up to 50 posts at once. Batch-update custom fields, ACF values, or any post meta.
manage_redirects
Create 301, 302, or 307 redirects via the Redirection plugin. Essential after merging posts, changing slugs, or restructuring content.
delete_redirect
Remove an existing redirect by its source URL. Clean up old redirects that are no longer needed.

Media Management PRO (2 tools)

upload_media
Download an image from any URL and add it to your WordPress media library. Set title, alt text, caption, and description on upload.
update_media_meta
Batch-update alt text, titles, captions, and descriptions on up to 50 media items. Fix missing alt text across your entire library.

Taxonomy Management PRO (3 tools)

create_category_tag
Create new categories or tags with slug, description, and parent category support. Build your taxonomy structure via AI.
reassign_taxonomy
Move posts between categories or bulk-add tags. Add or replace taxonomy terms on up to 50 posts in a single call.
delete_category_tag
Delete categories or tags by ID or slug. Protects the default category from accidental deletion.
Get Pro License

Free vs Pro — Full Feature Comparison

Every capability side by side. See exactly what each version includes.

Capability Free Pro
Content Reading
Get post/page by ID, slug, or URL✓✓
Search content by keyword, type, category, tag, status✓✓
List posts with sorting and pagination✓✓
List categories and tags with counts✓✓
View post revision history✓✓
Read ACF field groups and values✓✓
SEO Auditing
Internal link mapping (outgoing, incoming, both)✓✓
Find orphan content (no incoming links)✓✓
Find thin content (below word count threshold)✓✓
Find stale content (not updated in X months)✓✓
Find missing SEO elements (excerpts, alt text, images)✓✓
Find duplicate titles (keyword cannibalization)✓✓
Content structure analysis (headings, readability)✓✓
Keyword density analysis✓✓
Find broken media (404 images)✓✓
Media Library
Search media by keyword✓✓
Browse media with filters (date, type, unattached)✓✓
Get all images for a specific post✓✓
Upload media from URL✗✓
Batch-update alt text, titles, captions (up to 50)✗✓
Technical & Health
Site info (name, URL, content counts, post types)✓✓
Technical info (PHP, WP version, plugins, theme)✓✓
Security audit (outdated software, debug mode, etc.)✓✓
Content calendar (publishing frequency, gaps)✓✓
Author statistics✓✓
Content Management (Write)
Create posts, pages, and custom post types✗✓
Update title, slug, content, excerpt, status✗✓
Trash and restore posts✗✓
Bulk update status (up to 50 posts)✗✓
Duplicate post with all metadata✗✓
Clone post as template (structure only)✗✓
Merge thin/duplicate posts into one✗✓
Schedule future publish dates✗✓
SEO Fixing (Write)
Batch-fix excerpts, categories, tags, featured images✗✓
Add internal links to post content✗✓
Update post meta / custom fields / ACF✗✓
Find and replace across site (dry run default)✗✓
Bulk update meta on 50 posts at once✗✓
Redirects & Taxonomy
Create 301/302/307 redirects (Redirection plugin)✗✓
Delete redirects✗✓
Create categories and tags✗✓
Delete categories and tags✗✓
Bulk reassign taxonomy terms (up to 50 posts)✗✓
Security & Infrastructure
OAuth 2.0 with PKCE authentication✓✓
Dynamic client registration✓✓
Per-client rate limiting✓✓
Request logging with stats✓✓
Client revocation from admin✓✓
Write OAuth scope for write toolsN/A✓
Totals
Total tools2445

Built-In Safety Guards

Every write tool is designed so you can trust AI with your WordPress site.

No Permanent Deletes
The trash_post tool moves content to WordPress trash — never permanently deletes. Everything can be restored via the admin or the restore_from_trash tool.
Dry Run by Default
The find_and_replace tool defaults to preview mode. It shows you exactly what would change — affected posts, occurrence counts — before you approve the replacement.
Bulk Operation Limits
Bulk operations are capped at 50 items per call. This prevents accidental mass changes and keeps server load manageable on any hosting environment.
Dual Authorization
Write tools require both a valid Pro license AND a "write" OAuth scope on the access token. Read-only tokens cannot execute write operations — even if someone tries.
OAuth 2.0 with PKCE
Industry-standard authentication. Tokens expire after one week. Revoke any connected client instantly from the WordPress admin. No API keys stored in plaintext.
Rate Limiting
Per-client rate limiting prevents any single AI tool from overwhelming your server. Configurable from the Security tab in plugin settings.

What Can You Do With It?

Real workflows that WordPress site owners use every day.

SEO Content Audit
"Find all posts with no internal links pointing to them." The AI runs find_orphan_content, identifies 257 orphan posts, and with Pro can add internal links to fix them — all in one conversation.
Batch Fix Missing Alt Text
"Go through my latest 10 posts and fix the missing image alt text." The AI uses get_media_for_post to find images, downloads them to understand the content, then uses update_media_meta to write descriptive alt text.
Content Migration
"Export all my published posts as markdown files." The AI calls list_posts, then get_post for each one, and saves them as .md files on your machine — structured data, not scraped HTML.
Merge Thin Content
"Find posts under 300 words and suggest which ones to merge." The AI uses find_thin_content, analyzes topic overlap, then merges related posts with merge_posts and creates redirects via manage_redirects.
Site Health Monitoring
"Give me a complete security audit." The AI checks WordPress version, PHP version, SSL status, debug mode, file editing, default admin users, plugin updates, and database prefix — all in one call.
AI-Assisted Publishing
"Create a draft post about chameleon care, find a chameleon image from my media library, and set it as the featured image." The AI uses create_post, search_media, and update_post — complete Gutenberg-formatted content with images.

Example Prompts You Can Use

Copy any of these into your AI tool after connecting. These are real prompts that work out of the box.

SEO Audit
"Find all published posts that have no incoming internal links from other pages on my site. Show me the worst orphan pages first."
Uses: find_orphan_content → identifies pages Google can't discover through your site's link structure
Content Health
"Which posts haven't been updated in over 18 months? Sort them by word count so I can see which ones are both stale and thin."
Uses: find_stale_content + find_thin_content → prioritize which old content to refresh or consolidate
Image Alt Text
"Go through my last 5 published posts, find every image that's missing alt text, download each image, look at what's in it, and write descriptive alt text for each one."
Uses: list_posts → get_media_for_post → AI vision analysis → update_media_meta (Pro)
Content Creation
"Create a draft post titled 'Complete Guide to Indoor Herb Gardens'. Find a relevant image from my media library and set it as the featured image. Add it to the Gardening category."
Uses: create_post → search_media → update_post (Pro)
Find & Replace
"I changed my brand name from 'GreenLeaf Co' to 'Verdant Studio'. Show me how many posts contain the old name, and where — but don't change anything yet."
Uses: find_and_replace with dry_run=true (Pro) → preview all affected posts before committing
Duplicate Title Check
"Do I have any posts with identical or very similar titles? I want to find keyword cannibalization issues."
Uses: find_duplicate_titles → identifies posts competing for the same search terms
Merge Content
"I have three short posts about email marketing tips (IDs 102, 145, 203). Merge them into one comprehensive guide, keep the oldest one as the primary, and set up 301 redirects from the other two."
Uses: merge_posts → manage_redirects (Pro) → consolidates thin content and preserves link equity
Site Security
"Run a full security audit. Check if WordPress and PHP are up to date, if debug mode is exposed, if file editing is enabled, and if any plugins need updating."
Uses: get_site_health + get_technical_info → comprehensive security and health report
Missing SEO Elements
"How many of my published posts are missing an excerpt? List the first 20 and generate a 2-sentence excerpt for each one based on the post content."
Uses: find_missing_seo_elements → get_post → update_seo_elements (Pro) → AI writes context-aware excerpts
Content Export
"Download all my published posts as markdown files, organized in folders by category. Include the featured image URL, publish date, and tags in the frontmatter."
Uses: list_posts → get_post (paginated) → AI writes structured .md files to your machine
Taxonomy Cleanup
"List all tags that have zero posts. Delete the unused ones and show me which tags have fewer than 3 posts so I can decide whether to keep them."
Uses: list_categories_tags → delete_category_tag (Pro) → clean up taxonomy bloat
Internal Linking
"Find my 10 most important posts (highest word count, published in the last year) that have zero incoming internal links. Then add a 'Related Posts' section to each one linking to 3 relevant posts."
Uses: find_orphan_content → list_posts → add_internal_links (Pro) → builds internal link equity automatically

Technical Details

For developers who want to understand what's under the hood.

Protocol
MCP (Model Context Protocol) with Streamable HTTP transport. All communication is JSON-RPC 2.0 over a single POST endpoint. Compatible with the MCP 2025-06-18 specification.
Authentication
OAuth 2.0 with PKCE (Proof Key for Code Exchange). Dynamic client registration — AI tools auto-register, no manual key generation. Token lifetime: 1 week. Refresh tokens supported.
WordPress Integration
Built on the WordPress REST API. Creates 4 database tables for OAuth (clients, tokens, authorization codes, request logs). Uses WP-Cron for cleanup. Zero frontend output.
Requirements
WordPress 5.0+, PHP 7.4+. No external dependencies. Works on shared hosting, VPS, and managed WordPress hosts. Optional: Redirection plugin for redirect management, ACF for custom fields.

Frequently Asked Questions

What is MCP (Model Context Protocol)?

MCP is an open protocol created by Anthropic that lets AI applications connect to external data sources and tools. Think of it as a standardized way for AI to talk to your WordPress site — reading content, running audits, and even making changes through a secure, authenticated API. It's supported by Claude Desktop, Claude Code, Cursor, and a growing number of AI tools.

Which AI tools work with this plugin?

Any AI tool that supports the MCP protocol via Streamable HTTP transport. This includes Claude Desktop (Anthropic's desktop app), Claude Code (CLI tool for developers), Cursor (AI code editor), and any other MCP-compatible client. The list is growing as more AI tools adopt the MCP standard.

Is my site data safe?

Yes. The plugin uses OAuth 2.0 with PKCE — the same authentication standard used by Google, GitHub, and other major platforms. AI tools must be explicitly authorized by a WordPress admin before they can access anything. Tokens expire after one week, and you can revoke access at any time from the plugin settings.

What's the difference between free and Pro?

The free version gives you 24 read-only tools for searching content, auditing SEO, checking site health, and browsing your media library. Pro adds 21 write tools that let the AI create posts, update content, manage media, handle redirects, and more. All write operations have safety guards — no permanent deletes, dry runs by default on find & replace, and bulk operations capped at 50 items.

Do I need coding skills to use this?

No. Install the plugin, go to Settings > Connect to AI, click "Copy Instructions for AI", and paste it into your AI tool. That's it. The AI handles the OAuth connection automatically — no API keys to configure, no code to write.

Does it work with custom post types?

Yes. Every tool that accepts a post type parameter works with any registered custom post type — WooCommerce products, portfolio items, testimonials, events, or any other CPT on your site.

Does it support Advanced Custom Fields (ACF)?

Yes. The free get_acf_fields tool lists all ACF field groups and their fields for any post type, including current values for specific posts. The Pro update_post_meta tool can read and write ACF field values — the AI knows exactly what fields exist before trying to update them.

Can the AI permanently delete my content?

No. The trash_post tool moves content to the WordPress trash — it never permanently deletes anything. Trashed posts can be restored from the admin trash or via the Pro restore_from_trash tool. The find_and_replace tool defaults to dry_run mode, showing a preview of changes before applying them. Bulk operations are capped at 50 items per call.

Does it work with Yoast SEO or RankMath?

Yes, indirectly. SEO plugins store their metadata as post meta fields. The Pro update_post_meta tool can write to any meta key — including Yoast's _yoast_wpt_metadesc, RankMath's rank_math_description, or any other SEO plugin's fields. The AI can audit SEO issues with the free tools and fix them with Pro.

How does the redirect management work?

The manage_redirects and delete_redirect tools integrate with the Redirection plugin by John Godley (a free WordPress plugin with 2+ million installs). You can create 301, 302, or 307 redirects and delete them — all through your AI assistant. If the Redirection plugin isn't installed, the tool returns a helpful error message.

What happens when I merge posts?

The merge_posts tool combines content from multiple posts into one primary post. It appends the content from source posts (separated by an HR tag), merges their categories and tags into the primary post, and moves the source posts to trash — never permanently deletes them. This is perfect for consolidating thin content that's hurting your SEO.

Can I use it on multiple WordPress sites?

Yes. Install the plugin on each site you want to connect. Each site gets its own MCP endpoint URL. In your AI tool, add each site as a separate MCP server. You can then switch between sites or query multiple sites in the same conversation.

Does it slow down my website?

No. The plugin only responds when an AI tool sends a request to the MCP endpoint. It has zero impact on frontend page loads — no JavaScript, no CSS, no database queries on regular page views. Rate limiting prevents any single client from overwhelming your server.

Is this plugin on WordPress.org?

No. Connect My Site to AI is distributed exclusively from this website (muntaseerrahman.com). This gives us faster release cycles and the ability to include Pro features in the same plugin file, gated by license key.

How do I upgrade to Pro?

Install the plugin (it includes both free and Pro code). Go to Settings > Connect to AI > License tab and enter your Pro license key. All 21 write tools are unlocked instantly — no re-uploading required.

Ready to Connect Your WordPress Site to AI?

Download the free plugin and connect in under two minutes. 24 read-only tools included. Upgrade to Pro when you need write access — create posts, fix SEO, manage media, and more through your AI assistant.

Download Plugin Get Pro License