lemonx_mcp_tools filter is presented as a concrete LemonX MCP capability for developers building lemonx-compatible tools or extending the mcp surface safely.
Registry WordPress-native MCP gateway
Tool Registry for WordPress.
The registry keeps LemonX MCP thin. Feature plugins register tool definitions with descriptions, input schemas, capabilities, callbacks, write flags and Pro feature keys. Let LemonX plugins contribute tools through the lemonx_mcp_tools filter without mixing business logic into the gateway.
Rendered for real WordPress use
Developers building LemonX-compatible tools or extending the MCP surface safely.
Version OKDevelopers building LemonX-compatible tools or extending the MCP surface safely.
WordPress scenario
Built for real MCP sessions inside production WordPress.
LemonX MCP is intentionally a thin gateway. It owns protocol transport, bearer-token authentication, tool discovery, resources, staged writes and audit records. Page editing, SEO research and translation actions stay inside the plugins that know those domains.
For this page, the practical goal is simple: Let LemonX plugins contribute tools through the lemonx_mcp_tools filter without mixing business logic into the gateway. The operator should be able to understand the value, the safety boundary and the exact WordPress workflow before connecting an AI client.
- Keep the gateway enabled only when a tokened client should connect.
- Bind each token to a WordPress user with the least useful permission set.
- Ask the agent to read site identity before doing site-specific work.
- Use staged previews for write actions and audit logs for accountability.
Scenario: an AI client talks to WordPress through LemonX MCP instead of unsupported raw REST calls.
How it works
POST /wp-json/lemonx-mcp/v1/mcpThe gateway keeps the AI surface predictable and reviewable.
Every MCP session starts with a client, a token, an endpoint and a clear operating manual. LemonX MCP then routes calls through the registry, permissions, feature gates and staging layer.
01
Feature plugin registers a tool with lemonx_mcp_Feature plugin registers a tool with lemonx_mcp_tools02
Tool declares schema, capability and write behavTool declares schema, capability and write behavior03
Gateway protects reserved names and surfaces warGateway protects reserved names and surfaces warnings04
Client lists the public catalogueClient lists the public catalogue05
Tool call is routed to the owning pluginTool call is routed to the owning plugin06
Stats record source plugin and feature key conteStats record source plugin and feature key contextKey features
What this page covers in the MCP product system.
These capabilities map to the real LemonX MCP plugin architecture and admin experience, not a generic AI automation promise.
Capability checks is presented as a concrete LemonX MCP capability for developers building lemonx-compatible tools or extending the mcp surface safely.
Callback ownership by source plugin is presented as a concrete LemonX MCP capability for developers building lemonx-compatible tools or extending the mcp surface safely.
Reserved name diagnostics is presented as a concrete LemonX MCP capability for developers building lemonx-compatible tools or extending the mcp surface safely.
Plugin data model
lemonx_mcp_settingsImportant internal concepts surfaced as product value.
LemonX MCP stores settings, tokens, stats, audit entries and staged payloads in WordPress options and transients. The website page should explain these concepts because they define trust.
| Concept | What it controls | Why users care |
|---|---|---|
| Gateway settings | enabled, rate_limit, trust_proxy_headers, cors and disabled_tools | Admins can turn the surface on, limit clients and hide tools without editing code. |
| Tokens | label, hash, user_id, preview, created and last_used | Each MCP client can have its own revocable identity bound to a WordPress user. |
| Staged payloads | tool, payload, preview, user_id and created time | Write changes wait for confirmation and expire after 15 minutes. |
| Audit entries | tool, write flag, result, source plugin, feature key, site, token and target | Teams can trace what an agent did, where it came from and which site it touched. |
Security language is crawlable text, not hidden inside an image, so both users and AI answer engines can understand the permission model.
Security and AEO readiness
Explain trust clearly for Google, users and AI answer engines.
This page is built with a clear H1, descriptive sections, direct answers, canonical metadata, SoftwareApplication schema, FAQPage schema and BreadcrumbList schema. That helps Google understand the page and gives AI answer engines concise source material to cite.
For MCP, trust language is especially important. The copy should repeatedly clarify that the gateway does not bypass WordPress permissions, write tools are staged, and actions are auditable.
- Use direct definitions near the top of every page.
- Keep security claims specific: token binding, capabilities, rate limits, CORS and staging.
- Use FAQ structured data for answer-engine-friendly summaries.
- Link related MCP pages so crawlers understand the feature cluster.
Recommended workflow
How teams should use Tool Registry in practice.
Start from the admin screen, verify site identity, expose only the tools that are needed, and use the preview workflow for anything that could change content. This is the difference between an unsafe browser agent and a controlled WordPress MCP gateway.
- Generate a separate token for each client and site.
- Ask the agent to call initialize and read the returned operating manual.
- Use resources/list or discovery tools before making assumptions about content.
- Apply changes only after reviewing the staging preview and target site context.
Recommended workflow: discover, verify, preview, approve, apply and audit.
FAQ
Common questions about Tool Registry.
What is Tool Registry?
Tool Registry is part of LemonX MCP 0.2.12. It helps WordPress teams let lemonx plugins contribute tools through the lemonx_mcp_tools filter without mixing business logic into the gateway.
Does LemonX MCP bypass WordPress permissions?
No. Tokens are bound to WordPress users, requests run as the bound user, and tools still rely on WordPress capabilities plus LemonX Pro feature gates for write-capable actions.
Can write tools change the site immediately?
Write-capable tools use the preview to apply workflow. The first call stages a preview and opaque payload; only apply_change commits the staged change after review.
Which MCP clients can use this?
The gateway is designed for Claude Code, Codex, Claude Desktop through the stdio bridge, and other HTTP or Streamable HTTP MCP clients that can send JSON-RPC requests with bearer authentication.
Is this page useful for SEO and AI search indexing?
Yes. The page uses a clear H1, descriptive sections, crawlable text, canonical metadata, SoftwareApplication schema, FAQPage schema, BreadcrumbList schema and direct answers for AI answer engines.
Connect AI clients to WordPress with a gateway you can audit.
LemonX MCP gives Claude, Codex and other MCP clients one controlled endpoint for WordPress work: token-bound users, tool discovery, resources, staged writes, Pro gates and activity records.