Note
Public mirror. The canonical repository is hosted on our self-hosted git. This GitHub copy is a read-only mirror kept in sync for visibility and installation. Bug reports are welcome via Issues; pull requests are applied upstream and synced back here.
The Model Context Protocol server connecting AI agents to Elementeer-powered WordPress sites.
A Node.js MCP server with 128+ tools in the Free tier, 250+ tools total, 65 fine-grained capabilities, and L0–L3 governance for safe AI-agent operation. Handles template composition, site assessment, brand setup, creator workflows, theme building, navigation, media, SEO, performance, translation, accessibility, LMS, charity, booking, e-commerce, and addon ecosystem management — all through a single protocol surface.
Companion plugin: elementeer/elementeer — exposes
/wp-json/elementeer/v1/on your WordPress site.
Download from elementeer/elementeer → Upload → Activate → Settings → Elementeer MCP → Generate Key.
npm install -g @elementeer/mcp
elementeer-mcp init # creates ~/.elementeer/config.jsonEdit ~/.elementeer/config.json:
{
"sites": [
{
"id": "my-site",
"name": "My WordPress Site",
"url": "https://yoursite.com",
"apiKey": "ek_your_key_here",
"default": true
}
]
}{
"mcpServers": {
"elementeer": {
"command": "elementeer-mcp"
}
}
}cap install elementeer-mcp| Tool | Capability |
|---|---|
list_templates |
library-operations:read |
get_template |
library-operations:read |
create_template |
library-operations:write |
update_template |
library-operations:write |
rename_template |
library-operations:write |
duplicate_template |
library-operations:write |
delete_template |
library-operations:write |
bulk_rename |
library-operations:write |
get_template_data |
library-operations:read |
update_template_data |
library-operations:write |
extract_sections |
library-operations:read |
list_by_type |
library-operations:read |
set_category |
library-operations:write |
set_tags |
library-operations:write |
audit_library |
library-operations:read |
| Tool | Capability |
|---|---|
assess_site |
site-audit:read |
get_recommendations |
site-audit:read |
get_site_info |
site-audit:read |
get_performance_report |
performance-operations:read |
flush_elementor_cache |
performance-operations:write |
| Tool | Capability |
|---|---|
wizard_brand_setup |
design-system:write |
get_site_settings |
site-settings:read |
update_site_settings |
site-settings:write |
| Tool | Capability |
|---|---|
creator_mode |
content-structure:write |
wizard_theme_builder |
theme-structure:write |
create_page / create_post |
content-operations:write |
update_post_meta |
content-operations:write |
delete_post |
content-operations:write |
list_taxonomies |
content-operations:read |
create_term / update_term / delete_term |
content-operations:write |
list_post_types |
content-operations:read |
| Tool | Capability |
|---|---|
list_menus / create_menu / delete_menu |
theme-structure:read|write |
list_menu_items / create_menu_item |
theme-structure:read|write |
update_menu_item / delete_menu_item |
theme-structure:write |
list_menu_locations / assign_menu_location |
theme-structure:read|write |
| Tool | Capability |
|---|---|
list_media / get_media |
media-operations:read |
update_media / delete_media |
media-operations:write |
audit_unused_media |
media-operations:read |
search_stock_images |
media-operations:read |
sideload_stock_image |
media-operations:write |
generate_ai_image |
media-operations:write |
| Tool | Capability |
|---|---|
get_seo_meta |
seo-operations:read |
update_seo_meta |
seo-operations:write |
| Tool | Capability |
|---|---|
queue_change |
governance:write |
list_change_queue |
governance:read |
review_change |
governance:review |
apply_change |
governance:apply |
All adapters auto-detect their respective plugins. Tools for WooCommerce, Voxel, Amelia booking, LearnDash/Tutor LMS, GiveWP/Charitable, accessibility (Ally), translation (WPML/Polylang), and addon ecosystem analytics — each with domain-appropriate read/write operations, widget inventories, usage tracking, and overlap detection.
Elementeer enforces a four-tier governance model for safe AI operation:
| Level | Description | Behavior |
|---|---|---|
| L0 | Read-only inspection | No consent needed — list, get, assess |
| L1 | Safe writes | Auto-executed — create, update metadata |
| L2 | Impactful writes | Auto-queued for human review — layout changes, brand setup |
| L3 | High-risk operations | Block until explicit consent provided — deletions, plugin conflict tests |
L2 tools call queue_change automatically. L3 tools require consent: true in the request. This gives AI agents the freedom to propose meaningful changes while keeping site owners in control.
Layer 1 — API Key Capabilities. Each key carries an explicit list of domain capabilities. A read-only key returns elementeer_insufficient_scope — not elementeer_invalid_key — on any write attempt, so the agent can guide the user precisely.
Layer 2 — Governance Settings. Site administrators configure allowed_capabilities in the WordPress admin. Even if a key has a capability, if governance blocks it, the server returns elementeer_governance_blocked. Site owners lock down entire domains without revoking keys.
The MCP server maps these error codes to typed ElementeerErrorCode values so AI clients receive actionable error information.
| Free | Advanced | |
|---|---|---|
| Tools | 128+ | 250+ |
| Sites | Unlimited | Unlimited |
| Template CRUD | ✓ | ✓ |
| Site Assessment & Recommendations | ✓ | ✓ |
| Brand Setup Wizard | ✓ | ✓ |
| Creator Light | ✓ | ✓ |
| Navigation & Content CRUD | ✓ | ✓ |
| Media Library | ✓ | ✓ |
| SEO Meta | ✓ | ✓ |
| Performance Basics | ✓ | ✓ |
| Addon Detection (11 adapters) | ✓ | ✓ |
| Wizard Workflows (5 families) | ✓ | ✓ |
| WooCommerce | — | ✓ |
| Amelia Booking | — | ✓ |
| AI Batch Translation | — | ✓ |
| Snapshots & Versioning | — | ✓ |
| Design Token Extraction | — | ✓ |
| Change Review Queue | — | ✓ |
| Performance Deep-Dive | — | ✓ |
| Studio Orchestration | — | 🔮 (Future) |
elementeer-mcp/
├── mcp-server/ # TypeScript MCP server
│ ├── src/
│ │ ├── index.ts # Server entry point & tool registration
│ │ ├── client.ts # Axios HTTP client for WordPress API
│ │ ├── config.ts # ~/.elementeer/config.json management
│ │ └── tools/ # 128+ tool implementations
│ ├── dist/ # Compiled output (npm entry: dist/index.js)
│ └── package.json # @elementeer/mcp v2.1.4
│
├── shared/ # Shared TypeScript types & validation
│ ├── src/
│ └── package.json # @elementeer/shared
│
├── mirror/ # Free mirror staging & sync scripts
│
├── capability.yaml # MCP capability manifest (65 capabilities)
├── TIERS.md # Tier comparison & pricing logic
├── CHANGELOG.md
├── ROADMAP.md
└── packages/ # npm workspace root
Tech stack: TypeScript 5.4+ (strict mode), Zod validation, Axios HTTP client, Vitest test runner, npm workspaces.
Elementeer MCP works with any MCP-compatible client.
{
"mcpServers": {
"elementeer": { "command": "elementeer-mcp" }
}
}{
"mcpServers": {
"elementeer": { "command": "elementeer-mcp" }
}
}opencode mcp add elementeer -- elementeer-mcpAs configured in their respective mcpServers settings — use elementeer-mcp as the command and add site configuration in ~/.elementeer/config.json.
cap install elementeer-mcpnpm install
npm run build
npm run test --workspace=mcp-server
npm run test:coverage --workspace=mcp-server
npm run test:watch --workspace=mcp-server
npm run test --workspace=shared- Fork and clone
- Create a branch:
git checkout -b feat/your-feature - Make changes with tests
- Run
npm test - Open a pull request using the template
- Documentation: docs.elementeer.xyz
- WordPress Plugin: github.com/elementeer/elementeer
- Conversion Bridge: github.com/elementeer/elementeer-bridge
- Pro Addon: github.com/elementeer/elementeer-pro (private)
MCP Server: Apache-2.0
Bundled Plugin (Free): GPL-2.0-or-later — see elementeer/elementeer.
Pro Addon: Proprietary — see elementeer/elementeer-pro (private).