wordpress-seo-mcp
Provides search analytics data and enables sitemap submission to Google Search Console when configured with API credentials.
Connects to WordPress sites via REST API to analyze and optimize SEO, including meta tags, schema, content, images, technical aspects, sitemap generation, and keyword suggestions.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@wordpress-seo-mcpAnalyze SEO for post 42 on my-site"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
WordPress SEO MCP Server
An MCP (Model Context Protocol) server that connects AI assistants to WordPress sites for automated SEO optimization. Works with opencode, Claude Code, Cursor, and any MCP-compatible AI.
Features
Tool | What it does |
| Add/list/remove WordPress sites |
| Check meta title, description, OG, Twitter tags |
| Fix missing/short/long meta tags |
| Inspect JSON-LD structured data |
| Inject Article, Organization, BreadcrumbList schema |
| Check headings, word count, keyword usage |
| Check alt text, lazy loading |
| Check canonical URL, robots, hreflang |
| Generate XML sitemap (optionally submit to Google) |
| Generate keyword ideas for a topic |
| Google Search Console analytics (if configured) |
| Undo last SEO changes |
| View change history |
Architecture
AI Assistant → MCP Protocol → Middleware Pipeline → Plugin System → WordPress REST API
├─ Logging ├─ Meta Plugin
├─ Auth ├─ Schema Plugin
├─ Validation ├─ Content Plugin
├─ Rate Limit ├─ Images Plugin
└─ Cache ├─ Technical Plugin
├─ Sitemap Plugin
├─ Keyword Plugin
└─ Integration PluginPlugin-based with SQLite audit log (enables rollback) and optional Google Search Console + PageSpeed integration.
Related MCP server: Respira for WordPress
Quick Start
Prerequisites
Node.js 18+
A WordPress site with REST API enabled and an Application Password
Install
git clone https://github.com/abnormal-yi/wordpress-seo-mcp.git
cd wordpress-seo-mcp
npm install
npm run buildConfigure in opencode.jsonc
{
"mcp": {
"wordpress-seo-mcp": {
"type": "local",
"command": ["node", "/path/to/wordpress-seo-mcp/dist/index.js"],
"enabled": true,
"environment": {}
}
}
}Restart your AI assistant. The server starts automatically and exposes all tools.
Usage Workflow
Step 1: Add your site
→ manage-sites({ action: "add", name: "my-site", config: { url, username, appPassword } })
Step 2: Analyze a page
→ analyze-seo({ site: "my-site", postId: 42 })
→ analyze-content({ site: "my-site", postId: 42, keyword: "seo tools" })
→ analyze-schema({ site: "my-site", postId: 42 })
Step 3: Apply fixes
→ apply-seo({ site: "my-site", postId: 42, fixes: ["missing-title", "missing-desc"] })
→ apply-schema({ site: "my-site", postId: 42, schemas: ["Article", "Organization"] })
Step 4: Generate sitemap
→ generate-sitemap({ site: "my-site" })
Step 5: Roll back if needed
→ rollback-seo({ site: "my-site", postId: 42 })Or just tell your AI:
"Optimize this WordPress page for SEO"
The AI runs the full pipeline automatically.
Google Search Console (optional)
Set these environment variables in your MCP config:
"environment": {
"GSC_API_KEY": "your-google-api-key",
"GSC_SITE_URL": "https://yoursite.com"
}Enables search-analytics tool and sitemap submission to GSC.
Development
npm run dev # Watch mode
npm test # Run tests (70+ tests)
npm run typecheck # TypeScript check
npm run build # Production buildProject Structure
src/
├── index.ts # Entry point — wires plugins + services
├── transport.ts # MCP stdio transport
├── orchestrator.ts # Tool registry + plugin interface
├── middleware/pipeline.ts # Middleware pipeline runner
├── plugins/
│ ├── management.ts # manage-sites tool
│ ├── meta/ # Meta tag analyzer + applier
│ ├── schema/ # JSON-LD analyzer + applier
│ ├── content/ # Content SEO analyzer
│ ├── images/ # Image SEO analyzer
│ ├── technical/ # Technical SEO analyzer
│ ├── sitemap/ # XML sitemap generator
│ ├── keyword/ # Keyword suggestion engine
│ ├── rollback.ts # Rollback + history tools
│ └── integration/ # GSC + PageSpeed tools
├── services/
│ ├── wordpress/ # REST API client + site pool
│ ├── storage/ # SQLite audit log
│ └── external/ # GSC + PageSpeed API adapters
└── types/ # Shared type definitionsThis server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/abnormal-yi/wordpress-seo-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server