Title: Airano MCP Bridge Author: airano Published: May 10, 2026 Last modified: June 4, 2026 --- Search plugins ![](https://ps.w.org/airano-mcp-bridge/assets/banner-772x250.png?rev=3527917) ![](https://ps.w.org/airano-mcp-bridge/assets/icon-256x256.png?rev=3527917) # Airano MCP Bridge By [airano](https://profiles.wordpress.org/airano/) [Download](https://downloads.wordpress.org/plugin/airano-mcp-bridge.2.11.0.zip) * [Details](https://wordpress.org/plugins/airano-mcp-bridge/#description) * [Reviews](https://wordpress.org/plugins/airano-mcp-bridge/#reviews) * [Installation](https://wordpress.org/plugins/airano-mcp-bridge/#installation) * [Development](https://wordpress.org/plugins/airano-mcp-bridge/#developers) [Support](https://wordpress.org/support/plugin/airano-mcp-bridge/) ## Description **Airano MCP Bridge** is the official companion plugin for [MCP Hub](https://mcp.palebluedot.live)( [source](https://github.com/airano-ir/mcphub)) — the AI-native management hub for WordPress, WooCommerce, and self-hosted services. It extends the WordPress REST API with dedicated routes that AI agents (Claude, ChatGPT, Cursor, VS Code Copilot) and the MCP Hub server rely on: * **SEO meta routes** — read and write Rank Math SEO and Yoast SEO metadata for posts, pages, and WooCommerce products. * **Media upload helper routes** — accept raw-binary uploads via `php://input`, which bypasses the `upload_max_filesize` PHP limit (still bounded by `post_max_size`). Unlocks reliable hero-image and large-asset uploads for AI-agent workflows. * **Capability probe** — reports the effective PHP + WordPress upload limits so MCP Hub can pick the right upload path automatically. **Features:** * **Rank Math SEO Support** — Full access to all Rank Math meta fields * **Yoast SEO Support** — Full access to all Yoast SEO meta fields * **WooCommerce Compatible** — Works with product post types * **MCP Hub media pipeline** — bypasses `upload_max_filesize` for AI-agent uploads * **Secure** — Requires WordPress Application Password + capability checks on every route * **Auto-Detection** — Automatically detects active SEO plugin and advertises capabilities * **Zero Configuration** — Works out of the box after activation **REST API Endpoints:** _SEO meta (namespace `airano-mcp-bridge/v1`)_ * `GET/POST /wp-json/airano-mcp-bridge/v1/posts/{id}/seo` — Post SEO data * `GET/POST /wp-json/airano-mcp-bridge/v1/pages/{id}/seo` — Page SEO data * `GET/POST /wp-json/airano-mcp-bridge/v1/products/{id}/seo` — Product SEO data( WooCommerce) * `GET /wp-json/airano-mcp-bridge/v1/status` — Plugin status + active SEO plugins _MCP Bridge helpers (namespace `airano-mcp/v1`, added in 2.0.0)_ * `GET /wp-json/airano-mcp/v1/upload-limits` — Effective PHP + WP upload limits * `POST /wp-json/airano-mcp/v1/upload-chunk` — Raw-body media upload (bypasses ` upload_max_filesize`) * `GET /wp-json/airano-mcp/v1/capabilities` — Effective capabilities + feature flags + available routes (added in 2.1.0) * `POST /wp-json/airano-mcp/v1/bulk-meta` — Batch post/product meta writes in a single HTTP round-trip (added in 2.2.0) * `GET /wp-json/airano-mcp/v1/export` — Structured JSON export: posts, pages, products + media + terms + meta, with post_type/status/since/limit/offset paging (added in 2.3.0) * `POST /wp-json/airano-mcp/v1/cache-purge` — Auto-detects active cache plugins( LiteSpeed, WP Rocket, W3TC, Super Cache, Fastest Cache, SG Optimizer) and invokes their purge API; always flushes object cache (added in 2.4.0) * `POST /wp-json/airano-mcp/v1/transient-flush` — Native transient cleanup with scope=expired/all/pattern (glob); optional site-transient handling on multisite( added in 2.5.0) * `GET /wp-json/airano-mcp/v1/site-health` — Unified site-health snapshot: PHP/ MySQL/WP versions, extensions, disk free, active plugins + theme, writability checks (added in 2.6.0) * `GET|POST|DELETE /wp-json/airano-mcp/v1/audit-hook` — Configure + query a webhook that forwards WordPress action events to MCP Hub (HMAC-SHA256 signed, non-blocking)( added in 2.7.0) * `POST /wp-json/airano-mcp/v1/regenerate-thumbnails` — Regenerate attachment sub- sizes via `wp_generate_attachment_metadata` for a list of IDs or in paged batch mode (added in 2.8.0) * `POST /wp-json/airano-mcp/v1/upload-and-attach` — Raw-body upload + metadata + attach-to-post + set-featured in a single REST call (added in 2.9.0). Query params: `attach_to_post`, `set_featured`, `title`, `alt_text`, `caption`, `description`. Permission: `upload_files` + `edit_post` on the target post. * `POST /wp-json/airano-mcp/v1/opcache-reset` — Reset PHP OPcache after a theme/ plugin deploy (added in 2.11.0). Permission: `manage_options`. * `GET /wp-json/airano-mcp/v1/transients` — Read-only inventory of transient keys + expirations; values intentionally never returned (added in 2.11.0). Capped at 500 per call. Permission: `manage_options`. * `POST /wp-json/airano-mcp/v1/term-update` — Mutate a taxonomy term via `wp_update_term`( added in 2.11.0). Accepts `taxonomy` (canonical name or REST base), `term_id`, and any of `name`/`slug`/`description`/`parent`. Permission: the taxonomy’s own` edit_terms` capability, enforced at the route gate. * `POST /wp-json/airano-mcp/v1/cache-purge` — As of 2.11.0 accepts an optional ` scope` body parameter (`all` / `page` / `object`, default `all`). **Designed for [MCP Hub](https://mcp.palebluedot.live)** — the AI-native management hub for WordPress and self-hosted services. [Try the live platform](https://mcp.palebluedot.live)· [Source on GitHub](https://github.com/airano-ir/mcphub). ## Installation 1. Upload the `airano-mcp-bridge` folder to `/wp-content/plugins/` 2. Activate the plugin through the ‘Plugins’ menu in WordPress 3. For SEO meta routes: ensure either Rank Math SEO or Yoast SEO is active 4. The REST API endpoints are now available ## FAQ ### Which SEO plugins are supported? Rank Math SEO and Yoast SEO. The plugin auto-detects which one is active. ### Does it work with WooCommerce? Yes. Product SEO endpoints are available when WooCommerce is active. ### How is authentication handled? All endpoints require WordPress Application Password authentication. SEO routes require `edit_posts`. Upload helper routes require `upload_files` or `manage_options`. ### Do I need MCP Hub to use the upload helper routes? No. The `/airano-mcp/v1/upload-chunk` route is a standard authenticated REST endpoint and can be used from any client that can send a raw-binary `POST` with `Content- Disposition` and `Content-Type` headers. ### Is there a size cap on the upload helper? The helper reads the request body via `php://input`, which is **not** subject to PHP’s `upload_max_filesize` limit — but it is still bounded by `post_max_size` and` memory_limit`. For files larger than `post_max_size`, MCP Hub falls back to its own server-side chunked session pipeline. ### Why keep the folder name “airano-mcp-bridge” even though the plugin now does more than SEO? Plugin slugs on wordpress.org are permanent. Existing installs keep working; the display name and feature set are updated in 2.0.0. ### Can I use this without MCP Hub? Yes. All REST API endpoints work with any application that can make authenticated HTTP requests. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Airano MCP Bridge” is open source software. The following people have contributed to this plugin. Contributors * [ airano ](https://profiles.wordpress.org/airano/) [Translate “Airano MCP Bridge” into your language.](https://translate.wordpress.org/projects/wp-plugins/airano-mcp-bridge) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/airano-mcp-bridge/), check out the [SVN repository](https://plugins.svn.wordpress.org/airano-mcp-bridge/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/airano-mcp-bridge/) by [RSS](https://plugins.trac.wordpress.org/log/airano-mcp-bridge/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 2.11.0 * Mark **Tested up to: 7.0** for the WordPress 7.0 release cycle. No behaviour change is required — every route exercises stable core APIs (`register_rest_route`,` wp_update_term`, `wp_cache_flush`, `opcache_reset`, etc.) and PHP 7.4+ which remains the project minimum. * Bump **Requires at least** from 5.0 to 5.6. The existing `/site-health` route already calls `wp_timezone_string()` (added in WP 5.3) and `wp_is_application_passwords_available()`( added in WP 5.6); Plugin Check correctly rejected the 5.0 floor against these functions. WP 5.6 shipped in December 2020, so this is a paperwork fix rather than a real audience shift. * New route: `POST /airano-mcp/v1/opcache-reset` — calls PHP’s `opcache_reset()` when available so a freshly deployed plugin / theme / CSS file is picked up without an FPM restart or shell access. Reports `opcache.enable` + `opcache.validate_timestamps` + before/after summary. Permission: `manage_options`. * New route: `GET /airano-mcp/v1/transients` — read-only inventory of transient keys + expirations (multisite-aware via `?include_site_transients=1`). Values are intentionally NEVER returned; this is for observability and cleanup discovery. Capped at 500 keys per call. Permission: `manage_options`. * New route: `POST /airano-mcp/v1/term-update` — taxonomy-term mutation through` wp_update_term()` that bypasses the stock REST limitation around translated-term slug conflicts. Accepts `taxonomy` (canonical name OR REST base), `term_id`, and any of `name` / `slug` / `description` / `parent`. Permission: enforced at the route gate via the taxonomy’s own `edit_terms` capability (no generic `manage_options`- only override). * Enhancement: `POST /airano-mcp/v1/cache-purge` now accepts a `scope` body parameter—` all` (default, identical to the v2.10.x behaviour), `page` (skip object cache), or `object` (skip page-cache plugins). Existing callers that send an empty body keep working unchanged. #### 2.10.3 * WordPress.org review fix: rename main class from the generic `SEO_API_Bridge` to `Airano_MCP_Bridge` per the wp.org “unique prefixes” guideline. The class is only instantiated from this file’s bootstrap line and is never referenced by callers (the plugin’s public surface is its REST routes, not its PHP class), so this is an internal refactor with no behaviour change. #### 2.10.2 * WordPress.org review fixes: - Drop the unused `wp-admin/includes/media.php` includes from `/upload-chunk` and `/upload-and-attach`. The code only uses helpers from `file.php` (`wp_tempnam`,` wp_handle_sideload`) and `image.php` (`wp_generate_attachment_metadata`) —` media.php` was a needless direct core include. - Split `/upload-and-attach` permission_callback into its own method (`require_upload_and_attach_capability`) that explicitly enforces `current_user_can('edit_post', $attach_to_post)` at the route gate when `attach_to_post` is supplied (no longer hidden inside the callback body), and rejects `set_featured` requests that don’t include a target post. * No behaviour changes for clients sending well-formed requests. #### 2.10.1 * Fix: `capabilities` and `site-health` routes now share a single source of truth for the `routes` bitmap (previously duplicated with conflicting values for `audit_hook` and missing `upload_and_attach`). Both endpoints now read from the shared route- map constant. #### 2.10.0 * `POST /wp-json/airano-mcp/v1/upload-and-attach` now honours an `Idempotency-Key` request header. A retry within 24 hours with the same key returns the already- created attachment (`_idempotent_replay: true`) rather than creating a duplicate`- 2.webp` orphan. Protects against client-timeout regressions where a successful upload was retried because the response was lost. #### 2.9.0 * Added `POST /wp-json/airano-mcp/v1/upload-and-attach` — same raw-body semantics as `/upload-chunk`, but accepts query params (`attach_to_post`, `set_featured`,` title`, `alt_text`, `caption`, `description`) and applies them in one PHP round- trip. Saves 2-3 REST calls per upload. Per-target permission enforced via `current_user_can(' edit_post', attach_to_post)`. * `status` + `capabilities` routes now advertise `upload_and_attach: true` alongside the existing capability flags. #### 2.8.0 * Added `POST /wp-json/airano-mcp/v1/regenerate-thumbnails` — rebuild attachment sub-sizes via `wp_generate_attachment_metadata()` after an upload or format conversion changes source pixels. Supports two modes: `{ "ids": [...] }` for targeted regeneration( up to 50 per call) and `{ "all": true, "offset": N, "limit": M }` for paged batches( max 50 per page, with `has_more` + `next_offset` for pagination). Non-image attachments are skipped; per-item permission check via `current_user_can('edit_post', $attachment_id)`. Permission: `upload_files` or `manage_options`. #### 2.7.0 * Added `GET|POST|DELETE /wp-json/airano-mcp/v1/audit-hook` — configure a webhook that forwards WordPress action events (post transitions, deletions, user events, plugin activations, theme switches) to MCP Hub for unified auditing. Each event is signed with HMAC-SHA256 using a shared secret and posted non-blocking via ` wp_remote_post` so the admin UI stays snappy. Secret is stored in `wp_options` and never echoed back in GET responses (only the last 4 characters are returned). Permission: `manage_options`. #### 2.6.0 * Added `GET /wp-json/airano-mcp/v1/site-health` — single-envelope health snapshot: WordPress version/multisite/locale, PHP version + critical extensions, server software + disk free, MySQL/MariaDB version + charset, active plugins list (with versions), active + parent theme, writability checks (wp-content, uploads) and SSL status. Replaces 5+ separate REST calls with a single request. Permission:` manage_options`. #### 2.5.0 * Added `POST /wp-json/airano-mcp/v1/transient-flush` — native PHP transient cleanup. Scopes: `expired` (default, calls `delete_expired_transients()`), `all` (delete every `_transient_%` row), or `pattern` (glob match, e.g. `rank_math_*`). Optional` include_site_transients` for multisite. Response includes `deleted_count` + capped` deleted_sample` for observability. Permission: `manage_options`. #### 2.4.0 * Added `POST /wp-json/airano-mcp/v1/cache-purge` — auto-detects active page-cache plugins (LiteSpeed Cache, WP Rocket, W3 Total Cache, WP Super Cache, WP Fastest Cache, SiteGround Optimizer) and triggers their purge API. Always calls `wp_cache_flush()` for object caches. Permission: `manage_options`. Removes the need for Docker- socket + WP-CLI to flush caches on managed hosts. #### 2.3.0 * Added `GET /wp-json/airano-mcp/v1/export` — structured JSON export of posts, pages, and WooCommerce products (not WXR). Query params: `post_type`, `status`,` since`, `limit` (max 500), `offset`, `include_media`, `include_terms`, `include_meta`. Response includes posts + referenced media + taxonomy terms + post meta in a single envelope, plus `has_more` / `next_offset` for pagination. Permission: ` edit_posts`. #### 2.2.0 * Added `POST /wp-json/airano-mcp/v1/bulk-meta` — writes many `post_meta` / `product_meta` entries in a single REST request. Capped at 500 items per call; each item is permission-checked via `current_user_can('edit_post', $post_id)`. Null meta values delete the key. Status endpoint now advertises `capabilities.bulk_meta = true` and the capabilities probe reports `routes.bulk_meta = true`. #### 2.1.0 * Added `GET /wp-json/airano-mcp/v1/capabilities` — reports the effective capabilities of the calling application password, plus feature flags (Rank Math / Yoast / WooCommerce / multisite) and the list of companion routes this version actually ships. Consumed by MCP Hub’s capability probe so per-user clients only see tools they’re actually authorised to use. * Status endpoint now advertises `capabilities.capabilities = true`. #### 2.0.0 * **Rebrand**: “Airano MCP SEO Meta Bridge” “Airano MCP Bridge”. The companion plugin is no longer SEO-only. * Added `GET /wp-json/airano-mcp/v1/upload-limits` — returns effective PHP + WP upload limits for MCP Hub probes. * Added `POST /wp-json/airano-mcp/v1/upload-chunk` — raw-body upload route that bypasses `upload_max_filesize`. * Status endpoint now includes `capabilities: { seo_meta, upload_limits, upload_chunk}`. * Plugin folder / slug unchanged: `airano-mcp-bridge` (permanent on wordpress.org). #### 1.3.0 * Added REST API endpoints for posts, pages, and products (GET/POST operations) * Added authentication requirement for all endpoints * Fixed rank_math_title meta key registration #### 1.2.0 * Enhanced WooCommerce product support * Improved MariaDB compatibility #### 1.1.0 * Added status endpoint for plugin detection * Improved error handling #### 1.0.0 * Initial release with Rank Math and Yoast SEO support ## Meta * Version **2.11.0** * Last updated **2 months ago** * Active installations **40+** * WordPress version ** 5.6 or higher ** * Tested up to **7.0.2** * PHP version ** 7.4 or higher ** * Tags * [AI](https://wordpress.org/plugins/tags/ai/)[mcp](https://wordpress.org/plugins/tags/mcp/) [media](https://wordpress.org/plugins/tags/media/)[rest-api](https://wordpress.org/plugins/tags/rest-api/) [seo](https://wordpress.org/plugins/tags/seo/) * [Advanced View](https://wordpress.org/plugins/airano-mcp-bridge/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/airano-mcp-bridge/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/airano-mcp-bridge/reviews/) ## Contributors * [ airano ](https://profiles.wordpress.org/airano/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/airano-mcp-bridge/)