NV Digital Open Operator System (NV oOS)
OfficialIntegrates Cloudflare's AI models for language processing and inference.
Provides a toolkit and dashboard for managing Cloudways hosting environments, including server management and deployment.
Offers adapters for integrating the system with Craft CMS, enabling content management and AI-powered features.
Provides Elementor widgets that allow users to add AI-powered chat and content generation to Elementor-built pages.
Integrates Google Gemini AI models for multimodal understanding, content generation, and chat.
Provides access to Hugging Face's model inference API for a wide range of AI models.
Offers adapters for integrating the system with Laravel applications, enabling AI capabilities within Laravel projects.
Integrates NVIDIA NIM for accelerated AI model inference and content generation.
Provides integration with Ollama to run local AI models for chat, generation, and agentic tasks.
Primary AI provider integration providing access to GPT models, including streaming, function calling, and agentic loops.
Allows building Telegram Mini Apps that interface with the system's AI capabilities for chat and automation.
Core integration enabling AI-powered management of WordPress sites, including posts, pages, media, user interactions, and site settings.
Click on "Deploy 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., "@NV Digital Open Operator System (NV oOS)publish a new blog post about AI trends"
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.
NV Digital Open Operator System (NVoOS)
Version: 1.1.71 Release Date: 2026-09-05
See ยง Previous Releases for all version history.
๐ v1.1.71 Highlights: A rate-limit, model-catalog & ecosystem release. REST rate-limit blocks are now liftable โ the general request limiter uses fixed-window accounting (honest retry_after, no infinite slide) and flags the restriction registry via a new wp_mcp_ai_rest_request_rate_limit_exceeded action, so blocked users appear in the Command Center Restrictions tab with the existing Lift button. wake_up_context enforces wing/room scope (Graphify graph anchors no longer leak cross-wing memories into a wing-scoped block). The September 2026 model catalog refresh ships โ 228 models (gpt-5.6 family, gpt-6-astra preview, gpt-image-2, claude-opus-5, gemini-3.6/3.7/3.8-flash, kimi-k3), retired DeepSeek/gemini-3.1-flash/imagen-4 IDs with migration-map successors, pricing drift fixes, and new defaults (gemini-3.6-flash, gpt-image-2, kimi-k3). The checkout-api addon joins the standard build + test pipeline and its token/crypto classes now derive salts from wp_salt() (no more latent fatal on installs without salt constants). The Content Graph ecosystem advances: the standalone plugin ships its 1.0.4 visual experience system, Content Graph AI gains the assistant-builder block set + settings shell, and the platform completes its Wave E2 queue layer (async job queue โ queue manager โ job queue manager โ dead-letter queue). Connectors links point at the real core screen. Coding-time agent skills: 54 (new mcp-ai-wpoos-updates skill). Tool count: ~303 base + ~1,263 Pro (~1,566 total).
MCP Specification: 2026-07-28 (Stateless Core, Full Compliance)
Maintained by NV Digital
License: GPLv3 or later
Requires: WordPress 6.0+, PHP 7.4+
Patent Status: Patent Pending (Application #19/410,504)
Documentation: Grade A (95/100) โ 1,617 files across 12 directories, 108 admin screenshots, 100% feature coverage
๐ For Reviewers & Auditors
New to this repo? Start here โ
docs/project/FOR_REVIEWERS.mdThat document answers every common question in one place: what the project is, current security posture, what's production vs experimental, PHP version requirements, AI development methodology, compliance status, and scoping advice for a limited-budget review.
Quick links for reviewers:
Addon Inventory โ what each of 27 addons does and its status
Security Posture โ current state of all 50 audit findings
Compliance Traceability โ every .org rejection reason โ commit โ verification command
AI-Assisted Development โ methodology, transparency, and what to scrutinize
Architecture Overview โ component diagram and data flow
Related MCP server: WP MCP Ultimate
๐ Table of Contents
Getting Started
Core Functionality
Addons & Extensions
Orchestration & AI Features
AI Providers & Integration
Performance & Optimization
Remote MCP Setup
Assistant Management
Development
Reference
๐บ Repository Map
Directory | Purpose |
| Core plugin classes โ admin, assistants, tools, services, REST, security (10 infrastructure classes), providers (~15 AI backends), harness, data, markup, measurement, skills, professions, teams, slash-commands, A2A/ACP protocols, federation, elementor, blocks, crawler, integrations |
| Framework-agnostic AI orchestration engine (nvoos/core): 32 domain contracts, 21 WordPress adapters, ChatOrchestrator, ProviderRouter, ToolRegistry, SkillRegistry โ PHP 8.1+ |
| 27 installable addons (Pro, Chat SPA, Docs Hub, SaaS Controller, Cloud Worker, Cloudways Dashboard, Toolkit Shell, Canvas, Canvas Toolkit, Document Editor, Media Studio, Media Worker, Graphify, Comic Reader, Funiq Bridge, Fleet Operator, Algorave, Cornerstone3D, Crocoblock DS, Embedded, Fantasy Football, LibreChat, Schedule Anything Platform, Schedule Anything SPA, Tenant Router, Page Agent, Checkout API) |
| Frontend JS/CSS, images, CSV templates, examples |
| 54 coding-time agent skills for Zed editor (20 wp-* WordPress plugin development patterns + 31 design-* skills + mcp-ai-wpoos-plugin operational guide + mcp-ai-wpoos-test-suite repair guide + mcp-ai-wpoos-updates maintenance guide) |
| 6 BMAD workflow agent YAML definitions + team composition config |
| Subsystem context files (10 topics + 5 templates) for agent session loading |
| Standalone plugins: NVOOS Content Graph, NVOOS Content Graph AI, NVOOS Content Graph AI Platform |
| 23 NPM packages under |
| TMA (Telegram Mini App) builders + workflow builder source |
| Shared source code across builds |
| Standalone "core" distribution ( |
| Site blueprints |
| Agent and workflow example code |
| Hermes WebUI dashboard extensions (fleet monitoring/control plane, backup-download, external-app-tab, mcp-tool-shortcuts) |
| PHPUnit test suite |
| Comprehensive documentation (~1,600 files across 12 directories) |
| Development and deployment scripts |
| Docker Compose configuration |
| Translation files (.pot/.po/.mo) |
| Dependency patches |
| CI/CD workflows (~30 pipelines), custom agents, Copilot instructions |
๐งฉ Overview
Real-time AI Orchestration Toolkit for Wordpress - NV oOS is a modular AI framework (Object-Oriented System) for WordPress that connects your site's data with 15 language-model providers: OpenAI, Gemini, Anthropic, DeepSeek, OpenRouter, Baseten, Kimi (Moonshot), Z.AI (GLM), DigitalOcean, NVIDIA NIM, Cloudflare Worker AI, Ollama, LM Studio, Hugging Face, and Flowhub. It allows you to create and manage AI Assistants that can interact with users, access WordPress data, and perform custom tool functions.
โจ What's New at a Glance (v1.1.71)
๐ REST Rate-Limit Unlock & Fixed-Window Timer (PR #6322). Users blocked by the general request limiter never appeared in the Command Center Restrictions tab, so admins couldn't lift the block. Two bugs: the limiter never flagged the restriction registry, and the window was sliding (every request rewrote the transient with a fresh full-window TTL, so steady traffic kept the block alive and
retry_afteralways reported the full window).check_rate_limit()now uses fixed-window accounting ({count, first_seen}, TTL never extended past window end) with honest remaining-timeretry_after; a newwp_mcp_ai_rest_request_rate_limit_exceededaction makesWP_MCP_AI_Restriction_Registryflag arate_limitrestriction (auto-release at window end) โ the block shows in the Restrictions tab + Token Manager with the Lift button, and lifting clears the request window. Guest (IP-keyed) blocks expire on their own.๐ง MemPalace Wing-Scope Enforcement (PR #6327).
WP_MCP_AI_Tool_Wake_Up_Context::matches_wake_filters()now enforceswing/roomexclusions โ the Graphify graph anchors only boost scores and never excluded out-of-scope memories, sowake_up_contextin auto mode leaked cross-wing memories into a wing-scoped block once the Graphify addon loaded. The PR also ships four test-isolation fixes (transcript mock restore, shared registry teardown, provider-key isolation, logging cache reset).๐ Checkout API Into the Addon Pipeline (PR #6315).
bin/build-addon-zips.shnow producesbuild/nvoos-checkout-api-v<version>.zip, the addon's 6 suites joinphpunit.xml.dist, and the build workflow gains atestsjob. The new suite exposed a latent production fatal: the token/crypto classes readAUTH_KEY . SECURE_AUTH_KEYdirectly โ nowwp_salt( 'auth' ) . wp_salt( 'secure_auth' )(identical on normal installs, stable fallback otherwise).๐งญ September 2026 Model Catalog Refresh (PR #6328). 217 โ 228 models: new
gpt-5.6-sol/-terra/-luna,gpt-6-astrapreview,gpt-image-2,claude-opus-5,claude-fable-5.1,claude-mythos-5,gemini-3.6/3.7/3.8-flash,gemini-3.5-flash-lite,deepseek-v4-flash-vision-exp,kimi-k3,kimi-k2.7-code; retired DeepSeek chat/reasoner/coder +gemini-3.1-flash+imagen-4with migration-map successors; pricing drift fixes (DeepSeek v4-flash input 10ร, Claude Opus inputs $15 โ $5); new defaults (gemini-3.6-flash,gpt-image-2,kimi-k3); ~45 derived files updated; 517 model tests / 8,290 assertions green.๐ Content Graph Ecosystem (PRs #6316โ#6321, #6325). The standalone
nvoos-content-graphplugin ships its 1.0.4 visual experience system โ theme engine (PHP/JS byte-identical, WCAG 2.2 SC 1.4.11 โฅ3:1 palettes), appearance settings tab, 24 SVG type glyphs, legend/minimap/zoom/keyboard explorer chrome,GET /edgesroute, export at 1โ3ร, block/shortcode attribute parity, and a checkout fallback redirect (#6318). Content Graph AI gains the assistant-builder block set (selector, tools grid, knowledge base, builder) and a validate-then-sanitize settings shell (#6316, #6317). The platform completes its Wave E2 queue layer:AsyncJobQueueโQueueManagerโJobQueueManager(atomicSELECT โฆ FOR UPDATE SKIP LOCKED) โDeadLetterQueue, byte-identical to the base stack (#6319โ#6321, #6325).๐ Connectors Links Fixed (PR #6314). The "Settings โ Connectors" links now use
admin_url( 'options-connectors.php' )โ the oldadmin.php?page=connectorstarget isn't a registered page.๐งช Post-K16 Singles (PR #6327, CI run 91942465749). Order-dependent singles closed: transcript session-key mock restore, shared tool-registry teardown (Pro OKF tools were wiped by
clear_tools()), Site Health provider-key isolation, transcript-mining logging cache reset. Themcp-ai-wpoos-test-suiteskill grew to 40 patterns.๐ New Coding-Time Skill (PRs #6323, #6324).
.agents/skills/mcp-ai-wpoos-updates/codifies the two maintenance tracks โ docs & release catch-up (Track A) and model catalog & config updates (Track B). Coding-time agent skills: 53 โ 54.
โจ What's New at a Glance (v1.1.70)
๐ก๏ธ Shell-Call Hardening on exec-Disabled Hosts (PR #6295). The Pro Packages page (and five other Pro admin pages + the OCR service) fataled on hosts with
execindisable_functionsโ on PHP 8+@cannot suppress the disabled-functionError. Canonicalwp_mcp_ai_check_nodejs_available()/wp_mcp_ai_get_nodejs_version()helpers probe exec-first and fall back toWP_MCP_AI_Process_Service(proc_open); the OCR service gainsis_cli_tool_available()/run_cli_command()(Windows-aware) and guardedproc_*calls; seven CPT/settings pages clamp negative inputs withmax( 0, โฆ )instead ofabsint()(absint('-5')โ5).๐ Wave-5 Production Fixes (PRs #6280โ#6312). Transcript
attachmentsdisplay metadata preserved on save + defaultmax_tokenscapped by the model's window (#6280); Pro dashboard event stats accept underscore and dashed slugs (#6281); validatedweb_searchprofession_tagsaligned (#6282); schedule presets drop a phantomvalidate_contact_datastep and put the hook inschedule_data(#6283); mesh peer URLs validated beforeesc_url_raw()(#6285); opt-in guest memory capture writes under a sharedguestbucket (#6286); JetEngine gates requireJET_ENGINE_VERSION+ a physical CCT-table probe, the JFB submissions tool restoresid/flat params, and the token manager uses the cached Pro tool map (#6296, #6300); complexity routing restored โ the default model no longer short-circuitsselect_model()(#6298); Auth0 audience validation is structural, image tools checkread_postagainst the acting user, and user IDs validate as positive ints (#6301, #6305); markup REST errors return400, the legacy SSE handshake is filterable, skill packs reject numeric-keyed entries and always fire their installed action (#6302); clamp sanitizers + plugins-integration terminate seam (#6303); Elementoris_elementor_editor_init()+static::is_available()(#6304); provider-prefixed model-slug token limits, Ollama native tool-calls fix,published_datepreservation,wp_mcp_ai_missing_image(#6306); agentic events reach the recent-activity feed + millisecond trace durations (#6308); K16 bundle โsanitize_key-stable webhook IDs, settings-repository blob fallback for runtime gates, acting-user chartunfiltered_html, social-publish date reset, PSO inflections, site-builder h1โh6, schema-verifierrequired(#6311); curriculum exporter skips empty structures (#6293).๐งช PHPUnit Repair Campaign, Wave 5 (~29 test PRs, #6280โ#6312). Two CI triage runs (
CI-TRIAGE-91006542428.md+CI-TRIAGE-91771001271.md) drove the clusters closed: transcripts, charts/dashboards, professions, presets, Cloudflare, mesh, memory, CPT management, PayHere, Mubert, OpenAI Images, composer drift, Content Graph AI, pro schedule AJAX, model routing, Gemini, JetEngine/Graphify stubs, OAuth, REST/skill packs, admin settings, Elementor, permission gates, HTTP clients, orchestration budget, logging, K16 misc singles. Themcp-ai-wpoos-test-suiteskill's cluster board is compacted to one completed wave-5 block (37 patterns unchanged).
โจ What's New at a Glance (v1.1.69)
๐๏ธ Vision Analysis Toolkit (Pro, PR #6267).
analyze_image_objectsdetects and counts objects per category โdetection(HuggingFace OWLv2 / Ollama vision),vlm(OpenAI / Anthropic / Gemini JSON-enforced counting), andhybrid(detector owns counts, VLM only renames mislabeled categories) โ withannotate=truereturning a GD box-annotated copy as a media attachment. Gated by a new NV oOS โ Vision Analysis settings page (enable_vision_analysis_toolkit, off by default) with SSRF URL-guards. Seedocs/toolkits/vision-analysis-toolkit.md+docs/proposals/vision-analysis-object-counting-tool.md. Pro tool count +1.๐ tagDiv Admin Compat & Metabox Crash Fix (PRs #6266, #6278). The four SiteKit tools no longer return the non-existent
CAPABILITY_CAN_USE_IF_ADMINconstant (string flag arrays; the assistant tools metabox crashed exactly atsitekit_get_adsenseon nugl.com). The sortable shim prints a bundled jQuery UI 1.14.2 Sortable inline whenevertd_wp_adminis enqueued (print-queue detection); the WordPress media chain is forced as direct head tags from core-registered handles; tools metabox CSS is enqueued in the head.๐ง DeepSeek Empty-Schema 400 Fix (PR #6272). Argument-less tools now emit
properties: {}(never[]) across 29 files;LegacyToolAdapterpreserves object maps and upgrades empty arrays; the AI Tool Builder scaffold emitsnew stdClass()for parameterless tools.๐ ZipSlip Guard Revived (PR #6270).
ZipArchive::$num_filesdoesn't exist on PHP 8.x, so the guard loop never ran โ unsafe archives imported successfully.count( $zip )now drives all five entry loops (OKF bundle manager + four Pro admin pages), restoring path-traversal rejection.๐ Fixes. Rate limiter classified by the dispatching request's real HTTP verb with a separate nefarious-monitor counter and dual-shape chat hook tolerance (#6265); one broken tool's shortcut tasks can't fatal the assistant edit screen (#6271); model catalog: gpt-4o 128k context,
gemini-2.0-flashvideo-capable typo, claude-sonnet-4-6/gpt-4o active status, two Qwen entries (#6274); settings save no longer leaves object-cache additions suspended (WP 7.1 inline-async tick locks, #6277).๐งช PHPUnit Repair Campaign Continuation (~9 test PRs, #6260โ#6276). Fourth wave: count-tokens params, continuation seam, SSE handler, deterministic cache tests, coverage manifest, incorrect-usage notices, admin registration, subtab sanitizers, 14 Veo suites. The
mcp-ai-wpoos-test-suiteskill now distills 37 root-cause patterns.
โจ What's New at a Glance (v1.1.68)
๐งฉ Pro SPA v2 Shortcode & Embedded Mode (Pro, PR #6256). New
[nvoos_pro_spa]shortcode mounts the Pro SPA v2 in chat-first embedded mode โAgentPanel+ drawers, tool shortcuts, OKF drawer, router-free, no admin routes โ with per-instancedata-configattributes and optional guest mode via the base guest-token machinery. NewWP_MCP_AI_Pro_SPA_Shortcode+Pro_SPA_Config+ module-registry entry +spa-v2block. Seedocs/project/proposals/033-pro-spa-v2-shortcode-proposal.md.๐ฅ๏ธ Hermes Dashboard Fleet Extensions (PR #6249). New top-level
extensions/tree: a fleet monitoring + control plane extension (nv-oos-fleetโ Python plugin API over ~35 sites), plusbackup-download,external-app-tab, andmcp-tool-shortcutsWebUI extensions with installer + smoke tests. Plans:docs/developer/integration/hermes-dashboard-extensions-plan.md.๐ Chat-Bubble Stale-Nonce Self-Heal (PR #6225).
GET /mcp-ai/v1/session/noncereturns a fresh session-boundwp_restnonce minted from the request's own auth cookie (no-cache); the chat client silently retries403 rest_cookie_invalid_noncefailures from full-page caching or session-token rotation on long-lived SPA pages.๐ Docs Hub 0.4.2 (PRs #6246, #6253). Internal links on local pages resolve to
#/slughash routes; TOC anchors mirror github-slugger exactly; "Accept fix" suggestions are directory-relative and../links are validated with containment checks; skipped rows show reasons; sync failures surface "Atomic swap failed"; the emoji loader no longer crashes the React SPA. Addon bump 0.4.1 โ 0.4.2.๐ Providers Disabled by Default on Fresh Installs (PR #6255). OpenAI/Anthropic/Gemini default to disabled; dropdowns list only enabled + credentialed providers; the onboarding wizard auto-enables the provider whose key you enter.
๐ Fixes. Google Calendar granted-scopes
%20corruption (#6226); TiptapmergeAttributesprototype pollution โ canvas/document editor pin tiptap 3.30.4 (#6250);fast-uri>=4.1.4 across npm trees (#6244); assistant untrash restores the pre-trash status (#6239); presets gain missing Google/Gmail/Drive/OKF/git tools (#6242);wp_mcp_ai_seed_task_templatesAJAX wired (#6243); jQuery UI sortable shim for post screens (#6258); agent-identity canonical-ID int cast (#6232); token-budget catalog dedup + restoredwp_mcp_ai_model_tpm_limitfilter seam (#6233).๐งช PHPUnit Repair Campaign Continuation (~21 PRs, #6224โ#6257, + #6259 merged upstream). A third wave kept the suite aligned with current contracts; the production fixes it carried are grouped above (including the late-merged
wp_mcp_ai_attachment_segment_providerfilter โ providers without a remote file API, e.g. Ollama, resolve attachments to local references).๐งน Housekeeping. Stale 1.1.67 build ZIPs removed (27 files).
โจ What's New at a Glance (v1.1.67)
๐งฉ Content Graph AI Platform v2.0.0 Standalone (PR #6123). The extracted
nvoos-content-graph-ai-platformaddon now carries its own business logic โ Waves AโC + Blueprints deliver the namespace-bridged admin UI (PlatformDashboard,PlatformSettingsRegistry), skill/slash-command/agent bridges, harness router, a 74-skill bundled-skills pack with third-party notices, a knowledge base, and a dedicated PHPUnit matrix. Seedocs/project/plans/content-graph-platform-extraction-plan.md.๐งฑ Base+Pro โ Content Graph Ecosystem Port, Wave D + D-UI (PR #6142). The AI runtime lands in
nvoos-content-graph-ai: chat core (optimizer, caches, rate limiter, summarizer, threads, attachments, transcripts, ChatKit), providers (Zai, Google Maps, Realtime ร3, RabbitMQ, STDIO, file services), model management + analytics/token tracking, security guards, and D-UI assistant pages + blocks/widgets/guest tokens/memory/CLI/MCP JSON-RPC. Content Graph AI bumps to 1.0.4. Tracked indocs/project/ecosystem-port-tracker.md.๐ง Google Workspace Gmail + Drive Read Tools (Pro, PRs #6151โ#6152). Six new Pro tools โ
get_gmail_message,get_gmail_thread,list_gmail_connections,modify_gmail_message(destructive-ops gated) andget_drive_file,list_drive_connectionsโ backed by newWP_MCP_AI_Pro_Gmail_Client/WP_MCP_AI_Pro_Google_Drive_Clientclients on the sharedincludes/google/foundation. Pro tool count +6.๐งช PHPUnit Repair Campaign Continuation (~100 PRs, #6114โ#6208, #6209โ#6222). A second cluster wave kept the suite green through the extraction/port work and PHPUnit 11 / WP 7.1 drift; the production fixes it carried are grouped in the changelog (crawler contract hardening, REST guards, LLM sanitization delegation, URL-encoded external-API queries, Veo 5s floor, settings/cache fixes, WhatsApp webhook signature rejection, HTTP 304 cached-body re-serve, Veo async-job completion ordering, token-budget display, Shopify client-availability filter seam, Paper Store array-field queries). The
mcp-ai-wpoos-test-suiteskill now distills 26 root-cause patterns.๐งน Housekeeping. Stale 1.1.66 build ZIPs removed; re-created 1.1.65 ZIPs re-removed.
โจ What's New at a Glance (v1.1.66)
๐งช PHPUnit Suite Repair Campaign (~100 PRs). The single-process suite was repaired cluster-by-cluster โ REST endpoints, AJAX handlers, provider/client suites, admin pages, chat/channel integrations, CRM, professions/teams, multi-agent orchestration, cron/notifier, federation, healthcare interop, security, logger, transcripts. Most PRs are test-only; the production fixes they carried are grouped in the bullets below. (PRs #6008, #6009, #6012โ#6107)
๐ REST, Auth & Permissions. Assistant-access caching โ new
wp_mcp_ai_assistant_access_cache_enabledfilter plus WP_Error caching like successful lookups (#6008); attachment-segment validation errors return explicit 400s (#6009); token-tier endpoint + tier-change audit logging (#6018); permission-callback allowlist refresh (#6019); bearer-auth context sync (#6014, #6016); REST analytics endpoints (#6015).โฑ๏ธ Job Queue, Cron & Notifier. Closure serialization fixed for legacy option storage (#6020); custom-table query guards against missing schema (Graphify DB, job store, tenant DB) end the 1.5K-line CI error-log flood (#6022); restored notifier
update_status()with dot-preserving job IDs + owner-scoped REST routes (#6036, #6037); job status promoted to running on progress updates (#6039); Little's-law metrics (#6038).๐ค Provider, Tool & Envelope Fixes. Web-search result building restored for Exa/Perplexity (#6042); auto-categorize router/client (#6064); Cloudways analytics adapter auth check (#6062); Media Toolkit tools normalized to
WP_Error(#6057); Remove Background path guard + source resolution (#6072); memory-capture failure envelope restored (#6049); A2A webhook logging + delegate tool errors (#6055).๐ฅ๏ธ Admin, Render & Output. Output-buffer leaks fixed across render/AJAX paths (#6045); Graphic Editor Plus image access on WP 6.9+ (#6069); workflow-editor AJAX WP_Error/hook drift (#6070); quiz + document-template admin pages wired (#6089, #6090).
๐ Professions, Federation & Addons. Profession meta clamping + primary-role flow, team CPT sanitization (#6043, #6105); federation mesh-sync init (#6044); defensive Graphify admin loading on the PM submenu (#6106); Content Graph AI bumped to 1.0.3 with a permission-check fix (#6056).
๐ New Coding-Time Skill.
mcp-ai-wpoos-test-suiteโ Docker commands, CI-log triage, 16 recurring root-cause patterns, and the cluster-PR conventions; coding-time skills now 53. (PR #6108)๐ณ Checkout API Addon + Content Graph Paid Checkout. New
addons/checkout-api/(v0.1.0, vendor-server only) โ Stripe session/verify endpoints, encrypted secrets, custom-table license store, signed expiring ZIP downloads, webhook license issuance/revocation, per-IP rate limiting โ plus the paid-checkout client in the freenvoos-content-graphplugin (Stripe Payment Element, verify, license, one-flow install; no Stripe keys in the plugin). Addon count: 27. (PR #6063)
โจ What's New at a Glance (v1.1.65)
๐ง OpenAI Reasoning-Model Parameter Fix. o-series and gpt-5 models reject
max_tokens(and o-seriestemperature) โlib/core'sOpenAiCompatibleClientnow strips unsupported parameters per model (applyModelConstraints()) and retries 400 rejections with corrected payloads on both sync and streaming paths. (PR #5985)๐ท๏ธ Media Worker Full-Crawl4AI Proxy (031 Phase 3). New env-gated
POST /api/crawl/full+GET /api/crawl/full/task/:idroutes forward to aCRAWL4AI_FULL_URLdeployment โ SSRF-validated targets before proxying, token-gated,503 service_not_configured/502 upstream_unreachableenvelopes โ plus a strict-pathTEMP_ROOTallowlist (proposal 028 Q5) for Docker shared-volume deployments. Worker stays v3.2.0. (PR #5983)๐ก๏ธ Security-Posture Findings Closed (issue #5972). Algorave Tone.js raw eval now requires one explicit confirmation per browser session plus a visible warning banner (capability-scoped); the TMA markdown source map is removed; remaining webhook
__return_truepermission callbacks carry justification comments.SECURITY_POSTURE.mdupdated. (PR #5981)๐ฌ Chat, REST & Transcript Hardening. Legacy clients sending a top-level
attachmentsparameter are tolerated instead of hard-400'd; custom message roles work again (wp_mcp_ai_allowed_message_roles); orphaned tool messages are silently discarded before provider dispatch; attachment prep errors propagate to the client; transcript pagination preserves negative values so clamping works; Content Graph AI embeddings stop 500ing and graph context falls back to keyword search without an index. (PRs #5991, #5993, #5994, #5985)๐ Webhook & Tool Fixes. Google Chat gains a shared-secret
verification_tokenfor OIDC-disabled webhooks; Slack link/italic conversion ordering fixed; paper-store import/export tolerate missingcollection; scheduled-result block registers idempotently; Graphify treats provider-prefixed*_keyfields as sensitive and returns canonicalWP_Errors;remote_wp_connectionerrors direct callers tolist_connectionsfirst. (PRs #5990, #5986, #6003)โ๏ธ Slash Commands, Blocks & Admin. Slash-command handler staleness on
initre-fire fixed; CSV list parsing accepts"1,2"and"1, 2"; assistant-builder/Pro toolkit blocks register idempotently (WP 7.1 notices); workflow AJAX double-output fix; TPM limits fall back to the bundled model catalog without JetEngine; dangling legacy admin settings removed; WP 7.0 connector registry guard. (PRs #6000, #5997, #6004, #6005, #6006)๐ฆ Content Graph wp.org Refresh. Icons (v5), main screenshot, and a generated page preview for the
nvoos-content-graphlisting; Contributors field fixed; Content Graph AI chat tester fixed. (PRs #5980, #5988, #5982, #5992)๐งช Test-Suite Cluster Fixes. SSE stream-contract alignment, WP 7.1 bootstrap neutralisation, transcript/slash-command/remote-connection suite follow-ups. (PRs #5995โ#5999, #6001, #6002)
โจ What's New at a Glance (v1.1.64)
๐ Google Calendar Connection & Shared Google Services. New
includes/google/foundation (OAuth service, Calendar v3 client, scope registry, credential resolver, sync + push) replaces four copy-pasted and drifted Google OAuth flows; agoogle_calendarconnection type lands on both connection surfaces. Six new Pro tools inaddons/pro/includes/tools/google-workspace/โlist_google_calendars,list_google_calendar_events,update_google_calendar_event,delete_google_calendar_event,check_google_calendar_availability(freeBusy),quick_add_google_calendar_eventโ plus a reworkedcreate_google_calendar_event(scope-enforced writes, Meet links) and async_google_calendarthat actually syncs. Seedocs/developer/architecture/integrations/google-calendar-connection.md. (PR #5959)๐ฌ Composio Account Health & Hardening (Pro). A verified account-health engine probes live credentials with catalog-discovered read-only tools (no invented slugs), a new
composio_manage_accountstool handles validate/reconnect/delete/prune, and the Remote Sites Connected Apps table gains a Health column with Verify/Reconnect actions. Auth config resolution, connected-account listings, identity-bound execution, app removal, zero-argument payloads, and proxied provider failures are all fixed. Seedocs/composio-connect.md. (PRs #5932โ#5934, #5936, #5953, #5958)๐ต๏ธ Non-Loggable Result Fields. Tools whose results carry capability credentials under innocuous keys (or opaque URL path segments) can declare the exact fields via the new
WP_MCP_AI_Tool_Sensitive_Result_Interface; the logger masks them before preview truncation. Logging-only โ caller/model payloads are never altered. (PR #5961)๐ Log Hygiene. Per-entry context budgets (fingerprinting + truncation) stop
wp_mcp_ai_recent_errors/wp_mcp_ai_recent_activityfrom ballooning into the megabytes; Data Management gains one-click Compact/Delete for both buffers; credential-bearing URL query params are redacted from every logged string. (PRs #5952, #5954)๐ Fixes. Validated-tool argument validation restored on Symfony 5.4 (constraint loading was silently skipped โ every validated tool accepted invalid input); MCP JSON-RPC
-32700/-32600error envelopes reachable and the diagnostics page re-wired; Pro SPA v2 conversation/assistant sync; vision tools accept a 5โ300stimeout; WP_Error envelope drift + cron/memory/elementor tool bugs. (PRs #5957, #5960, #5962, #5964, #5965)
โจ What's New at a Glance (v1.1.63)
๐งฌ Artifact Evolution Phases AโG (Base + Pro). The Continual Harness Evolver and Meta-Harness become a complete, gated, Darwinian evolution loop for skills, prompts, and roles: competing artifact populations with fitness-weighted parent selection, failure-case replay + post-mutation verification, learning-log-aware mutators, a pre-commit admission gate (structural / harmlessness / marginal-gain critics), holdout-gated deployment with shadow A/B serving and drift-triggered rollback, and a cross-cutting governor with a human approval queue and per-artifact lineage graphs. The
evolve_harnessโ Evolver contract is repaired, and every layer is opt-in (default off) with switches in Settings โ Orchestration Layer. Seedocs/project/proposals/007-artifact-evolution.md. (PRs #5923, #5925)๐งฉ Pro Addons Page (Pro). New registry-driven NV oOS Pro Dashboard โ Addons page installs and activates standalone addons whose ZIPs ship in the plugin's
build/directory in one click โ nonce +install_plugins+ allowlist gated, with non-WordPress components (Media Worker, Cloud Worker, Tenant Router, Schedule Anything SPA) listed read-only. (PR #5924)โก Chat Storage Worker Offload. Conversation saves at or above
wp_mcp_ai_storage_worker_threshold(default 10,000 chars) offload the expensiveJSON.stringifyto a browser storage worker; small saves, unload flushes, and worker failures fall back to the synchronous main-thread write, and the threshold filter is the kill switch. Seedocs/project/proposals/032-chat-web-workers-wiring-implementation-plan.md. (PR #5928)๐ DeepSeek Empty-Schema Fix. Empty tool-schema property maps now encode as
{}(never[]) at all three payload boundaries, fixing DeepSeek 400s; legacy tools are wrapped before the first register attempt so the fail-loud registry log only fires for genuinely unregisterable classes. (PR #5926)๐ OKF Skill-Knowledge Conformance. All 91 bundled SKILL.md files gained the OKF v0.2-required
type: Skillfrontmatter and the four missing cross-linked reference files were restored โ the OKF Validate tab no longer reports missing concepts. (PR #5919)๐งช Test-Suite Exit Traps. New
bin/sweep-tests.phpsweeps every test file in parallel to surface exit-trap and drift failures; AJAX test contracts land in the bootstrap and 24+ test files align with the catchable-die/admin-handler contracts. Minimal production fixes: bare-exit test seams, duplicate CRM workflow-rule class rename, toolkit MCP scope check +nvoos://resource URIs, SSE/Veo polling-limit filters. (PR #5929)๐ง Pro SPA v2 Slash Commands.
/chat,/new,/clear,/copy,/exportnow insert reliably from the slash-command drawer. (PR #5920)
โจ What's New at a Glance (v1.1.62)
๐ OKF Bundle Management (Base). New
WP_MCP_AI_OKF_Bundle_Managergives OKF knowledge bundles a full lifecycle โ create, list, rename, archive, delete, ZipSlip-safe ZIP import/export, and health statistics โ with the auto-generatedskill-knowledgebundle protected from writes. Three new tools (okf_list_bundles,okf_validate_bundle,okf_import_bundle) join the extendedokf_write_conceptprovenance schema (resource/sources/usage_window/verified), and a new OKF Bundle Manager admin screen (Bundles / Browser / Editor / Import-Export / Validate) mirrors the Skill Manager UX. Seedocs/features/okf-integration.md.๐ OKF โ Skill Bridge (Pro).
load_skillnow resolvesbundle:concept_idnames into OKF concepts as loadable skills, gated per assistant (grant metabox, fail-closed), lifecycle (drafts rejected), and an optional minimum trust tier.๐ค OKF Auto-Enrichment & Hybrid Knowledge Router (Pro). The enrichment agent crawls published site content (posts, pages, taxonomy terms) into OKF concepts with cross-links โ deterministic and idempotent, AI summaries opt-in via filter โ while
route_knowledge_queryclassifies questions across OKF / vector / Paper stores and performs the OKF lookup when it is the primary route.๐งญ OKF Skills Drawer in Pro SPA v2 (Pro). A new read-only
mcp-ai-pro/v1/okfREST surface (bundles, concept browse/search, assistant skill grants) powers an in-chat OKF drawer: browse bundles and concepts and reference them from the conversation without leaving the chat surface.โก Vector Store Tools on the Responses API. OpenAI removes the Assistants API on 2026-08-26 โ all vector-store operations now run headerless on the Responses API with
file_batchesingestion (bounded polling + single-file fallback);list_vector_store_filesgainsfilter,search_vector_storegainsranking_options. Fixed: 404s on percent-encoded OKF concept routes (%2Fnow decoded).
โจ What's New at a Glance (v1.1.61)
๐ง Agent Identity Bridging in Memory Store & Recall. New
WP_MCP_AI_Agent_Identity_Resolver(includes/services/) resolves virtual agent keys (e.g.nvoos-pro-spa-memory-drawer,virtual_planner_1) to the canonical assistant post ID when storing agent context; chat-memory recall merges every alias bucket with per-recordstored_understamps. Memory drawers (base, chat-spa, pro-spa) show wing/room/stored-under chips, an agent-ID diagnostic, a show-all-scopes toggle, and refresh automatically on store events; graph-bridge and scoped-recall failures degrade gracefully. Seedocs/features/memory/chat-client-integration.md.๐ OKF Skill-Knowledge Bundle Generator. The
skill-knowledgeOKF bundle is now auto-generated from bundled skills on bootstrap (and refreshed after bundled-skill reinstall) โokf_searchand the other OKF tools work out of the box instead of failing with "OKF bundle not found: skill-knowledge". (PR #5911)๐ง undici ^7.29.0 jsdom Compatibility. The undici override is pinned to 7.29.0 โ jsdom 29.1.1 breaks on undici 8, which had vitest suites failing in seven addons; all CVE fixes are retained. (PR #5910)
๐ฆ nvoos-content-graph wp.org Review Reply & Report shipped and excluded from distribution ZIPs; content-graph CI checksum sync fixed. (PRs #5912, #5906)
โจ What's New at a Glance (v1.1.60)
๐ Restricted-User Flagging & Unblocking. Ephemeral rate-limit and token-budget blocks become persistent, reviewable restriction records with auto-expiry and audit logging โ one-click lift on the Token Manager "Restricted Users" panel (Base), a full Restrictions tab on the Pro Command Center, REST/AJAX/WP-CLI operations (
wp mcp-ai restrictions list|lift|add), IETF rate-limit response headers, and filterable chat rate limits (wp_mcp_ai_chat_rate_limit/wp_mcp_ai_chat_rate_limit_window). Seedocs/features/security/user-restrictions.md. (PR #5901)๐ฅ Conversation Import to Transcript CCT (Full, JetEngine). New
includes/conversation-import/subsystem imports ChatGPT, Google Takeout Gemini, Claude, ShareGPT, and OpenAI fine-tuning JSONL exports into the JetEngineai_chat_transcriptsCCT โ four new tools (conversation_import_detect|run|status|delete), an admin upload/preview page, WP-CLI, GDPR export/erase, and optional memory mining. Seedocs/user-guides/conversation-import.md. (PR #5898)๐งฉ Tool Schema Normalization. Tool argument schemas are normalized before provider payloads (DeepSeek client, REST
/toolsoutput, Tool Service, ChatOrchestrator), preventing provider streaming errors; the registry logs registrations skipped for a missing tool contract. (PR #5903)๐ WP_Error Fatal Fixes in the memory layer and REST chat-memory paths (
mine_agent_memory,retrieve_agent_memory,wake_up_context, request guard). (PR #5905)๐ฆ nvoos-content-graph v1.0.3 โ wp.org resubmission with WPCS/review fixes and
.wordpress-orgscreenshot assets. (PRs #5897, #5899, #5904)
โจ What's New at a Glance (v1.1.59)
๐ท๏ธ Media Worker Crawling & Crawl4AI Facade (v3.2.0). New
/api/crawl/*endpoints โ single-URL Markdown, batched crawling (sync or queued async), and link scans โ with a two-tier extraction pipeline (static Readability โ Turndown first, hardened Chromium fallback) behind the shared SSRF guard. A Crawl4AI-compatible facade lets the plugin'srun_crawl4ai_jobremote mode target the worker directly, with LLM-based structured extraction. Toolkit memory estimate now accounts for the worker sidecar. Seedocs/project/proposals/031-media-worker-crawl4ai-integration-plan.md. (PR #5892)๐ Research Tools Multi-Provider Hardening.
semantic_content_searchresolves embeddings through the shared provider abstraction (OpenAI, Gemini, Ollama, DigitalOcean) independent of the chat provider, falls back to keyword search, and skips mismatched-model vectors; new Gemini embedding provider.deep_researchretries empty/truncated completions across the provider chain and never caches empty reports. Two new read-only base tools:list_termsandlist_taxonomies. (PR #5893)๐ Docs Hub Rebuild & Broken-Link Fixes. The plugin updater now fires
wp_mcp_ai_plugin_updatedafter in-place updates; Docs Hub 0.4.1 auto-clears the cache and enqueues an async rebuild (plus anadmin_initversion-mismatch guard). Broken-link detection resolves links against the slug map, and suggestions are case-insensitive with clamped confidence. (PR #5894)๐ง Tool Registration Fixes. Legacy-format tool classes are auto-wrapped, ~32 previously-orphaned base tools are now registered, and the new
wp_mcp_ai_tools_initaction gives side-loaders a late registration point. QA container memory limits raised. (PR #5895)
โจ What's New at a Glance (v1.1.58)
๐ Composio Connect (Pro). New
addons/pro/includes/composio/subsystem bridges WordPress to the Composio MCP gateway: OAuth connection flow with state nonce, API client, trigger bridge, and signed webhook controller. Six new beta tools โcomposio_list_tools,composio_get_tool_schema,composio_list_connected_accounts,composio_create_connect_link,composio_execute_tool,composio_manage_triggersโ plus remote-sites admin and metabox panels. Seedocs/composio-connect.md. (PR #5889)โ๏ธ OOS Runtime Consolidation (Phases 0โ5.8). The OOS engine now reaches parity with the legacy path โ tool-surface and security-gate parity, an event-sourced session log, opt-in shadow mode (parallel parity runs serving the legacy result, zero user exposure) with
wp mcp-ai oos parityCLI, canary routing per assistant, scoped tools with a compaction seam, Pro composition & child binding (wp mcp-ai composition), and single-path telemetry. Seedocs/project/proposals/029-oos-orchestration-runtime-consolidation-implementation-plan.md. (PR #5881)๐ท๏ธ Standalone Plugins Renamed to Content Graph.
plugins/nvoos-graphifyโnvoos-content-graph,nvoos-graphify-aiโnvoos-content-graph-ai,nvoos-graphify-ai-platformโnvoos-content-graph-ai-platform(v1.0.2) with matching workflow and build-script renames. Theaddons/graphify/knowledge-graph addon is unchanged. (PR #5890)๐ Security Center Refresh Fix.
wp-apiscript now enqueued on the security tab โ posture refresh, IP tests, snapshot restore, compliance export, and self-test no longer throwapiFetch is not defined. (PR #5887)๐ deepmerge-ts CVE-2026-40345 overridden in the media-worker and Pro packages. (PR #5888)
โจ What's New at a Glance (v1.1.57)
๐ Plugin Updater Rework. New base-only update flow for wp.org base installs (check + in-place install via the GitHub base package; new "Base Version" panel in Settings โ Advanced). Installation no longer uses
Plugin_Upgraderโ updates are copy-in-place with a backup snapshot and automatic rollback, so ZIP top-level folder-name mismatches can't break updates. Pro version now read from the plugin header (get_pro_installed_version()), fixing drift in the admin page andwp mcp-ai pro status. (PR #5871)๐ค Hermes Chat โ Async Submit/Poll.
hermes_chatnow submits via/api/chat/startand polls/api/chat/stream/statusโ runs keep executing server-side if the MCP client drops, timeout expiry returnsstill_running+stream_id, and the approval gate is answered with the configuredHERMES_APPROVAL_MODEchoice. Fixed answer extraction for live WebUI payloads. (PR #5872)๐ Service Status Provider Detection. AI-provider detection now resolves credentials through
WP_MCP_AI_Credential_Resolver(plugin settings, WP 7.0 Connectors, env vars, PHP constants) instead of raw settings keys; new 135-line test suite. (PR #5874)๐ Fleet Operator Agent Context. New
addons/fleet-operator/.context/tree (18 files) โ addon conventions, Hermes ops, MCP integration, 6 operator roles, and task/memory templates for operator-agent sessions. (PR #5873)
โจ What's New at a Glance (v1.1.56)
๐ข Media Worker v3.0.0 โ Multi-Tenant Shared Worker Mode (v2.4.0).
SITE_TOKENSper-site isolation (fail-closed auth, namespaced files/queues/rate limits), per-site rate-limit overrides,SITE_TOKENS_PREVIOUSrotation. (PR #5866)๐ Phase 2 โ Per-Site Provider Keys & Observability.
SITE_PROVIDER_KEYSper-tenant AI provider credentials (withPROVIDER_KEYS_STRICTfail-closed mode), per-site usage counters, grouped temp TTLs, cluster-mode boot warnings, and a k6 load-test kit with split decision table. (PR #5868)๐ Phase 3 โ Scale Without Breaking Changes. Multisite per-blog worker tokens, plugin-side Media Worker Usage Reporter (opt-in daily cron),
SITE_TOKEN_<SLUG>/SITE_PROVIDER_KEYS_<SLUG>env merges, opt-in Redis rate-limit store (RATE_LIMIT_REDIS=1),PROVIDER_KEYS_FILEhot-reload, manual Velocity deploy workflow. All opt-in โ defaults unchanged.๐ Worker Routing Expansion. Document generation, OCR, video frames, health charts, email, QR/translate/PDF, and vectorization now route through the connected worker with local fallbacks; Pro settings lists worker-routed packages; new
probe-wordpress.phpconnectivity probe.๐ Rotation, Canvas v3, Cloudways. Zero-downtime token rotation (
WORKER_API_TOKEN_PREVIOUS), Canvas v3 napi prebuilds (compiler-free installs), Cloudways readiness hardening, live route bug fixes. (PRs #5863โ#5865, #5867)๐ค Hermes Tooling. WebUI MCP server (
bin/hermes-mcp-server.js) to drive a Hermes agent from Zed (sessions, synchronous chat, skill sync), SSH MCP bridge, hardened env-file parser, and the Zed Hermes Console profile. (PR #5862 + follow-ups)
โจ What's New at a Glance (v1.1.55)
๐ง MCP Agent Compatibility & Reliability. JSON-RPC errors now return HTTP 200 so agent SDKs that drop non-2xx bodies relay tool errors instead of hanging. New legacy HTTP+SSE transport with credential-bound sessions for SSE-only clients. Tool rate limiter is settings-driven with credential-token exemption; GET/HEAD no longer consume the request quota; raw
cred_*authorization headers accepted; async tool polling bounded at ~45s with inline kick of stuck jobs. (PR #5859)๐ Hermes Fleet Operator Addon. New
addons/fleet-operator/โ scopedop_operator credentials with audience binding, expiry, rate limits, and instant revocation so a supervisor agent (Hermes or any MCP/A2A host) can operate the site within an allowlist. Server-sidetools/listscoping +tools/callenforcement. Ships admin page, WP-CLI commands, Hermes config generator, 3-skill nvoos pack, runbook, and tests. (PR #5858)๐ Media Worker v2.2.0 Security Hardening. Timing-safe
X-Site-Tokenauth, SSRF guard, sandboxed Puppeteer launcher, rate limiting, Helmet headers, split health endpoints, request logging, graceful shutdown.WP_MEDIA_WORKER_TOKENconstant support in the plugin sidecar. Cloudways Velocity deployment guide + CI. (PR #5857)๐๏ธ Database Connection Pooling Stance (Proposal 023). RabbitMQ-aware gating of Action Scheduler fallback and DB polling cron, atomic concurrency-guard slot tracking (
mcp_ai_concurrency_slotstable + daily cleanup), PDO persistent connections in Graphify, configurable queue worker batch size, and Site Health checks for MySQL pool, queue depth, and RabbitMQ health. (PR #5855)๐ฆ PostCSS 8.5.26 (GHSA-6g55-p6wh-862q) and media-worker subtree sync workflow (PR #5856).
โจ What's New at a Glance (v1.1.54)
๐ PostCSS CVE-2026-69153.
postcssminimum bumped to 8.5.23 inpackage.jsonoverrides across 2 addons. Resolves a high-severity CVE in the CSS post-processor chain. (PR #5850)๐ MCP Async Tool Response Handling.
tools/callendpoint now correctly handles async tool responses โ the response handler was dropping results for tools that return promises or deferred execution. +111 lines. (PR #5845)๐ง Plugin Updater Integrity Check v2. Follow-up hardening to the post-install integrity check (v1.1.52): fixed phantom
bridge/file false-positive from stat cache, cleared PHPclearstatcache()after each file check, and handled main-file rename edge case. (PR #5846)๐ API Key Merged-Settings Fix (Research Tools).
deep_research,web_search, and 18 other research tools were reading API keys from the global option instead of the merged provider-specific settings. Now usesget_merged_credentials()so per-assistant and per-provider API key overrides take effect. 20 files, +37/-33 lines. (PR #5852)๐ง Design Skills Audit & Enhancement. All 22
design-*skills comprehensively enhanced with detailed operational instructions, cross-references, and tool-calling patterns. 7 new pro-toolkit skills created:design-ai-assistant-admin,design-crm,design-project-management,design-communications,design-services,design-team-management,design-vault, anddesign-security-ops. Total: 29 enhanced/created skills, ~8,000 lines of agent-facing content. (PR #5847)๐ OKF YAML Frontmatter Compliance. Added missing
type: Skillfrontmatter to all 22design-*skills (PR #5844). Fixed YAML frontmatter spec compliance for 9 design skills โ removed duplicate/invalid top-level keys that violated the OKF v0.2 schema. (PR #5849)๐ README TOC Anchor Fixes. Fixed broken TOC anchor links caused by Unicode emoji rendering differences (VS16-based emojis like ๐ชฒ๐ and U+26xx/U+27xx symbols like โ ๏ธโก) across GitHub's markdown renderer. (PR #5853)
๐งน Stale Build Artifacts. Removed 30 stale v1.1.52 build artifacts from the repository. (PR #5851)
โจ What's New at a Glance (v1.1.53)
๐ Shared Analytics Service. New unified analytics subsystem (
addons/pro/includes/analytics/, 1,489 lines) consumed by all Pro toolkits. 7 platform adapters: Meta (FB+IG), Twitter/X, LinkedIn, TikTok, WooCommerce, Google Analytics 4, and Cloudways monitoring. 5 immutable DTOs (Account, Post, Metric, TimeSeries, Report). Cross-platform normalization maps platform-specific metric names to a unified schema. Smart caching with stampede prevention. Token-bucket rate limiter per platform. Extensible adapter pattern โ register new platforms via$service->register_adapter(). MCP server registration and Site Health integration. Design Stack skill:design-analytics-reporting. (PR #5836)๐ก๏ธ Circuit Breaker & Execution Pipeline Hardening. Circuit breaker protection added to all remaining AI provider clients โ now active on all 15 first-class providers with configurable failure thresholds. Concurrency guard, cost tracker, and backpressure signals wired into the execution pipeline. The agentic loop now auto-throttles tool calls when system load is high. Plugin updater base-only UI fix after complete upgrade. Silent build asset failure now surfaces a clear error. (PR #5839)
๐ง Agent Skills Sync & Discovery.
sync-agent-skillsnow syncs project-owned design-* skills alongside wp-* skills โ 22 new coding-time skills (design-analytics-reporting through design-video-creation) auto-discovered by the Zed editor. Newmcp-ai-wpoos-pluginbundled skill. Base bundled skills increased from 45 to 67. (PR #5842)๐ง SSE Stream & Load Guard Fixes. SSE backoff counter now resets between successful stream reconnections. Rate-limit counter properly cleaned up after stream termination. Load Guard fatal error on PHP 8.1+ fixed โ no longer calls private
count_active_jobs(). (PRs #5841, #5840)๐ Documentation Catch-Up. CHANGELOG v1.1.53 entry documenting all missing features (Shared Analytics, circuit breaker, skills sync). README, CLAUDE.md, AGENTS.md, and 6
.context/files updated with current counts, review dates, and architecture details.
โจ What's New at a Glance (v1.1.52)
๐ Paper Store Remote Site Support. All 8 Paper Store tools now accept an optional
connection_idto proxy operations through Remote Site Manager. New REST API controller atmcp-ai/v1/paper-store(697 lines) enables remote CRUD. NewWP_MCP_AI_Paper_Store_Remotetrait handles dispatch. Newlist_mcp_toolsdiscovery tool (234 lines) for AI agent self-discovery โ filterable by toolkit and search term. (PR #5835)๐ Remote Connection CPT Auto-Discovery. Plugin-registered custom post types (including
paper_store) now appear automatically in remote connection post type access controls. No more manual slug entry.resolve_post_type_access()mirrors discovery logic on form submission. Multi-site gateway plan (1,429 lines) for hub-and-spoke federation targeting v1.5.0+. (PR #5834)๐จ Design System Tool Preset. New
design-systempreset with 72 tools across 13 categories: WordPress content, image generation/analysis/processing, web search/research, charts, document generation (14 tools), Paper Store (8), video generation/processing, social media, AI/memory, and utility. (PR #5837)โ Post-Install Integrity Check. Plugin updater now verifies 15 critical file paths after every update before reporting success. Prevents silent corruption on distributed filesystems (Cloudways). REST controller
require_oncecalls now guarded withfile_exists()checks. (PR #5833)๐ Documentation Catch-Up. 3 new feature docs: Paper Store, Remote Sites & Connections, MCP Protocol Version Negotiation. Updated: Tool Presets System (Design System preset), Plugin Updater (integrity check), DOCUMENTATION_INDEX, QUICK_REFERENCE, README, CHANGELOG.
๐ Fixes. Pro addon update visibility for wp.org base + standalone Pro (PR #5832). Docker chmod warning suppression (PR #5831).
โจ What's New at a Glance (v1.1.51)
๐๏ธ Orchestration & Harness Layer Gap Remediation. Comprehensive audit of AI orchestration and LLM harnessing against August 2026 industry standards (OWASP LLM Top 10, EU AI Act, NIST AI RMF, MCP/A2A protocols, OpenTelemetry GenAI). OWASP LLM Top 10 coverage: 20% โ 60%. EU AI Act compliance: 17% โ 67%. 6 new classes: Output Guardrail (OWASP LLM05 โ validates LLM responses for sensitive info/unsafe content), Citation Verifier (OWASP LLM09 โ cross-references claims against sources), Model Integrity Verifier (OWASP LLM03 โ supply chain security with blocked model list), Semantic Cache (two-tier: exact + embedding-based prompt caching), Canary Deployment (progressive model rollout with auto-rollback). Workflow Engine V2 graduated from feature-flag to GA. Red Teaming scripts (shell + PHP) for OWASP-aligned adversarial probes. 3 new docs: Orchestration & Harness Reference, EU AI Act Compliance Mapping, OWASP LLM Top 10 coverage matrix. (PR #5830)
๐ MCP Protocol Version Negotiation. Older clients (Zed, Claude Desktop, Cursor) rejected the hardcoded
2026-07-28protocol version. Server now negotiates the highest version both client and server support, falling back to2024-11-05when the client provides no version information. 2 files, +123 lines. (PR #5829)๐ Security Bumps โ Media Worker. multer 1.4.5-lts.1 โ 2.2.0 (DoS vulns patched, 1.x deprecated). nodemailer 8.0.5 โ 9.0.5 (GHSA-p6gq-j5cr-w38f raw bypass fixed). sharp 0.33.0 โ 0.35.3 (libvips CVEs CVE-2026-33327 etc.). No code changes โ APIs are unchanged across all three bumps. (PR #5828)
โจ What's New at a Glance (v1.1.50)
โ๏ธ Media Worker Sidecar. Docker-based Node.js sidecar with 11 Express route handlers: browser (Puppeteer), code (sandboxed), data (ETL), document (generation), email (rendering), image (manipulation), ocr (Tesseract), pdf, social (cross-platform), video (transcoding), and workflow (pipeline orchestration). Queue module with concurrent processing and retry logic. Pro integration via
WP_MCP_AI_Media_Worker_Settings+Media_Worker_Clienttrait for tool-to-sidecar communication. Docker DNS-to-IP loopback resolution for container networking. Pro services updated (Fluent FFmpeg, Language Detection, MJML, Nodemailer, OCR, Prettier, Video Frame Extractor). (PRs #5822, #5823)๐ Site Health Redeclaration Fix. Fixed PHP fatal error from function redeclaration in
ensure_site_health_dependencies()โ now guarded withfunction_exists(). (PR #5824)๐ NPM Security Fixes. nanoid, js-yaml, and dompurify vulnerabilities resolved across 11+ addon
package-lock.jsonfiles. (PR #5821)๐ค BMAD Agent Editing Conventions. Developer and QA agent YAMLs updated with code editing conventions for consistent agent behavior across sessions. (PR #5825)
๐งน WPCS Formatting Cleanup. Repository-wide PHPCS fixes: tabs, docblock formatting, and code style corrections across all PHP files. No functional changes.
โจ What's New at a Glance (v1.1.49)
๐ง Gemini Model Resolution Fix. Gemini client now uses the correct settings key instead of the deprecated
gemini-profallback. All model lookups routed through the canonical provider settings path. (PR #5817)๐ Update Reactivation & Release ZIP Cleanup. Plugin updater now correctly reactivates after update. Nonce-scoped update actions hardened. Dev files (
.agents/,.context/,.github/, IDE configs, test fixtures) excluded from release ZIPs via.distignoreand.gitattributes. (PR #5816)
โจ What's New at a Glance (v1.1.48)
๐ Shopify Sync Toolkit โ 7 Bug Fixes. Fatal error (
graphql_query()โgraphql()) on Admin API connection test. Dead code inlist_by_statusreplaced with directSELECT COUNT(*)query. Always-zero analytics count now uses actual API response edges instead of empty array. Duplicateget_option()call and redundant$sync_modeassignment removed. Infinite loop risk intruncate()eliminated โ paginated while-loop replaced with directDELETE FROM {table}. Double DB query per upsert halved via by-ref&$operationoutput parameter. Missingorderby/orderschema parameters added with sanitization passthrough. (PR #5815)๐ PHPCS CVE-2026-67434.
squizlabs/php_codesnifferbumped 3.13.4 โ 3.13.6 across 3composer.lockfiles. Resolves arbitrary code execution via crafted ruleset XML. Dev dependency only โ no functional impact.๐ Default Skill Catalogues. Brave Search Skills and all 22 WordPress Agent Skills added to the default skill catalogue for new assistants out of the box.
๐ ๏ธ NVoOS Graphify Standalone Plugins. 3 new standalone plugin ZIPs in
plugins/directory: Graphify v1.0.1, Graphify AI Platform v1.0.0, and Graphify AI v1.0.0.
โจ What's New at a Glance (v1.1.47)
๐ข๏ธ MySQL Connection Exhaustion Fix (Cloudways). Cron system overhaul with unified concurrency limits, per-process memory caps, and staggered offset scheduling to prevent connection-pool saturation. Activation bootstrap now uses connection throttling. Service status registry hardened. Pro status page JS, AJAX handler, and dashboard improvements. 7 files, +438/-89 lines. (PR #5809)
๐ Update Checker Cache Bust. Manual "Check for Updates" now clears cached release data and fetches live from GitHub Releases API. (PR #5810)
๐ Mermaid Security Fixes. npm audit fix in canvas-toolkit: mermaid 11.15.0 โ 11.16.1 resolves 5 CVEs (prototype pollution, CSS injection, DoS). (PR #5812)
โจ What's New at a Glance (v1.1.46)
๐พ Comprehensive Backup & Restore (Proposal 020). 11 modular export providers (8 base + 3 Pro) with JSON-based export/import. Admin UI with provider checkboxes and progress feedback. Covers settings, assistants, CPTs, custom tables, federation, addon options, toolkit options, JetEngine CCTs, license keys, and remote sites. +3,660 lines. (PRs #5805, #5807)
๐ GitHub-Based Plugin Updater. New
WP_MCP_AI_Plugin_Updaterclass fetches releases from GitHub API, installs via WordPressPlugin_Upgrader. Base-to-complete upgrade path in Settings โ Advanced. Pro addon update support with rollback. Cache bust on manual check. +772 lines. (PRs #5800โ#5804)๐ Abilities API Selective Adoption (Proposal 019). New
includes/abilities/framework โ Registrar, Bridge, Category Registrar, and Security Bridge for machine-readable plugin operations with JSON Schema contracts. Tool-ability interface for MCP/AI agent discovery. 5 test files. (PR #5799)๐ 6 New Default Skill Catalogues. Brave Search Skills, WordPress Agent Skills, Cloudflare Agent Skills, Google Workspace CLI, OpenAI Agent Skills, and Google Agent Skills added to default skill catalogue for new assistants out of the box.
๐ Status Page Fixes. Fatal error in Pro status REST endpoint resolved. JS errors and i18n text domain consistency fixed on the status dashboard. (PR #5806)
๐ฆ Knowledge Base Auto-Build. CI auto-builds
knowledge-base.zipwhen playbook files change. (PR #5797)๐งน PHPCS Cleanup. Parse error fixes from canonical envelope conversion, text domain mismatch corrections, and WPCS formatting across 100+ tool files. (PRs #5798, #5804)
โจ What's New at a Glance (v1.1.43)
๐ Security Hardening v1.1.43 (16 files). SSRF protection across 7 provider connection handlers + A2A agent URL. SQL table-name validation against injection. A2A per-assistant agent cards now auth-gated. Chat SPA /config and /manifest endpoints require authentication (no longer public). Missing args schemas on 7 REST endpoints. Guest rate-limiting now IP-based (DoS vector closed). 3 tool capability mismatches corrected. Centralized defense-in-depth capability gate in Tool Registry. PHP object injection prevention via
safe_unserializehelper.๐ MCP Protocol Upgrade (2026-07-28). Stateless core โ sessions retired,
server/discoverreplacesinitialize,_metaper-request capabilities,Mcp-Method/Mcp-Nameheaders on Streamable HTTP, TTL/cache-scope ontools/list. Legacy client shim for backward compatibility. 10 files changed.๐ OKF v0.2 Trust-Signal Support. Indentation-aware recursive descent parser with inline YAML mappings, nested object lists, and flow sequences. New trust-tier derivation (
unverified/machine-confirmed/human-reviewed), staleness checks,search()extension with trust filters. Newokf_validate_attestationtool. All 6 existing OKF tools surface trust signals. 15 files, 27 standalone smoke tests.๐๏ธ Pro Module Registry.
wp_mcp_ai_pro_init()decomposed from ~625-line monolithic function into a PSR-4 module registry with per-module loading, dependency ordering, and graceful degradation. Fixes broken require paths in module loader.๐ฏ Ideal Customer Profile (ICP) System (Pro CRM Phase G). 7-dimension scoring engine (0โ100) with fit+intent separation, behavioral decay, and negative scoring. 2 new MCP tools:
compute_icp_score,manage_icp_profile. Admin UI with profile list table and 7-tab editor.๐ง Profession & Playbook Sync Fixes (7 PRs). Playbook bulk sync silent failures now report errors. Force-regenerated playbook files no longer deleted. Undefined array key in playbook stats fixed. Duplicate profession slugs removed from knowledge base (312โ311 entries). Title fallback prevents duplicate posts on Update. Consumed-post collision fix ensures all unique KB entries create distinct posts. Test Model assistant dropdown restored.
๐งน Hexagonal Architecture Purity.
PlatformFlushInterfacecontract extractswp_ob_end_flush_allfrom framework-agnosticlib/core/SSE handler into a WordPress adapter โ zero WordPress references remain in nvoos/core.๐ก๏ธ Phase 3 Operational Security. Audit logger REST route hook corrected (
initโrest_api_init). Security posture signals hardened.๐ฆ Dependency Updates. WPCS bumped to 3.4.1 (CVE-2026-45293). Dev tooling: Phpactor LSP replaces Intelephense.
โจ What's New at a Glance (v1.1.42)
๐ก๏ธ Security Infrastructure Hardening. 7 new security infrastructure classes (Request Guard, Security Posture with 21 signals A-F grading, Destructive Ops Gate, URL Guard, Concurrency Guard, Cost Tracker, API Key Store). Site Health integration. Production hardening guide. CORS, rate limiting, error verbosity, and body size enforcement with admin dashboard posture signals.
๐๏ธ Framework-Agnostic Core (
lib/core/). nvoos/core package โ Hexagonal Architecture with 32 domain contracts + 21 WordPress adapters. ChatOrchestrator with RateLimiter + SemanticCompressor. 109 tools migrated to framework-agnostic format. ProviderRouter with 12-provider routing. 5 chat parity gaps closed.๐ก Status Page & Incident Communication (Pro). Maintenance window system with frontend banner, countdown timer, and multi-channel notifications. Incident workflow with phase state machine, phase-aware dispatcher, and lesson bridge. 4 new AI tools for service status and incident management.
๐ค Agent Skills & BMAD Agents. 21 coding-time agent skills for Zed editor covering WordPress plugin development patterns. 6 BMAD workflow agent YAML definitions with team composition config. Full
.context/subsystem context files with 8 topics + 5 templates.๐ต Algorave Addon. New live coding and algorithmic music generation addon with 9 tools, pattern/session CPTs, and REST API.
๐ Security Hardening (12 fixes). OAuth token lifetime controls, DICOM PHI auto-redaction, asset version stripping, exception guard, auth brute-force protection, SSE CORS filter, webhook secret indicator. 13 new security unit tests.
โจ What's New at a Glance (v1.1.41)
๐ OKF Integration (Open Knowledge Format v0.1). Google vendor-neutral knowledge format engine with 6 MCP tools for curated, deterministic knowledge management. All 41 bundled skills are now OKF v0.1-conformant.
๐ Security Compliance Fixes (11 HIGH/P0). HMAC-signed policy tokens for professional selector, health endpoint auth-gating, ZIP path traversal prevention, CSRF nonces on sync endpoints, SRI integrity hashes for all 6 CDN libraries, Google Chat OIDC hardening.
๐ง Playbook Sync Fixes. Duplicate AJAX handler conflict resolved. Silent sync failures now report errors to admin UI. CPT class loading guards prevent fatal errors during bulk reseed.
๐ Model Provider Credential Resolution. Model picker now resolves API keys from all 4 sources โ settings, credentials option, environment variables, and PHP constants.
๐ก๏ธ Dependency Security. adm-zip, axios, and brace-expansion bumped to resolve 18 Dependabot alerts across 5 package.json files. npm audit: 0 vulnerabilities.
โจ What's New at a Glance (v1.1.40)
๐ Content Format Awareness. New
WP_MCP_AI_Content_Format_Helperdetects and preserves Markdown, HTML, and plain text formats across post-modifying and analysis tools โ AI-generated content retains its intended structure through the full create/update pipeline.๐ Research โ Paper Store โ WordPress Draft Pipeline. All research tools now support
save_to_paper_storefor staging results in the flat-file Paper Store. Newcreate_post_from_researchPro tool bridges staged research to WordPress drafts. Human-in-the-loop review before publishing.๐ฌ Demo Video Pipeline Complete (Phases 0โ5). Scripted scene recording with AI voiceover narration. GitHub Actions CI workflow automates video assembly. 14 narration scripts and video catalog.
๐ Settings Credential Split. Sensitive API keys moved from
wp_mcp_ai_settings(autoload) to separate non-autoloadwp_mcp_ai_credentialsoption with transparent merge. One-time migration.wp_suspend_cache_additionand dual cache clearing for defense-in-depth.๐ค Kimi & DeepSeek Client Parity. Both providers now match all first-class providers: streaming, tool use, token tracking, and error handling. Plus DeepSeek and 9 missing providers added to all research tools.
๐ Model Catalog Update (July 2026). 24 files updated across base + pro. Default bumps: Gemini
gemini-2.5-flashโgemini-3.5-flash, NVIDIAmeta/llama-3.1-8bโnvidia/nemotron-3-nano-30b-a3b, Gemini Livegemini-2.5-flash-liveโgemini-3.1-flash-live-preview.๐๏ธ OOS Engine: SchemaStoreInterface + Tests. New domain contract, PostTypeSchema/TaxonomySchema entities, GetPostTypeSchemaTool, WordPress adapter. 45 new tests.
โก SSE HTTP/2 Fixes.
ob_clean()replacesob_flush()to prevent protocol errors. 524 timeout resolved in Pro SPA v2.๐ Vector Store Sync โ No Polling. Status now checked only on assistant change and page load, reducing API load.
๐ง Settings Import/Export Batch (4 fixes). Credential merge, save key wipe, subtab sanitization, export consistency โ all resolved.
๐ก๏ธ Validated Tool Slug Allowlist. Tool slug matching fixed for validated variants.
โจ What's New at a Glance (v1.1.39)
๐ค Page Agent Addon v0.1.0. New addon (
addons/page-agent/) โ AI-powered browser page control copilot powered by Alibaba Page Agent (MIT). Give any WordPress page its own AI agent that can click, type, and navigate via natural language, running entirely client-side with no headless browser required. Includes shortcode, Elementor widget, REST endpoints, and MCP tool bridge.๐ฌ Pro SPA v2 โ Major Parity Update. Voice pipeline, tasks drawer, workflow tracker, and file attachment upload to WordPress Media Library. Tool Shortcuts and Slash Commands drawers. Mobile hamburger sidebar toggle. Speech/audio button fixes using correct REST endpoint. Conversation title improvements and turn count display fix. Button and token NaN display fixes. Model sync and auth bypass fixes. Assistant preloading in runtime config.
๐จ Pro SPA v2 โ UI Polish. Autoscroll fixes (submit, streaming start, user-at-bottom guard, scrollTop vs scrollIntoView). Viewport height fixes via CSS height chain instead of viewport calc.
overflow:hiddenon height-chain ancestors.filemtimecache-busting across all SPA addons. Lint errors resolved.๐ค Per-User Chat Memory Preferences. Users can now toggle chat memory on/off from their WordPress user profile. Individual control over AI memory retention without affecting site-wide defaults.
๐ create_post / save_post Tool Enhancements. Markdown-to-HTML conversion via new
WP_MCP_AI_Tool_Markdown_Convertertrait. Smart taxonomy suggestions auto-detect relevant categories and tags. Block content corruption fixed for non-post post types.๐ Workflow Blueprint & Schedule Improvements. Existing-content awareness in Content Publisher and Keyword Pipeline blueprints. Blog schedule presets now check for duplicate content before publishing. Readable response generation for workflow schedule result delivery.
โฟ SPA Accessibility. Annotation pills made clickable with meaningful screen-reader labels.
๐ก๏ธ Security. OWASP ZAP DAST medium findings triaged as false positives.
โจ What's New at a Glance (v1.1.37)
๐ญ EZuite Inventory Sync Pro Toolkit. ERP-integrated inventory sync bridging EZuite ERP with WooCommerce/WordPress. Pull products, query inventory, create/update items, manage orders, and configure API credentials โ all via AI tools. Admin UI with connection selector, field mapping, and sync direction controls. CLI sync commands for batch operations.
๐ Ralph Loop CCT Migration & Orchestration. Circuit breaker pattern with configurable failure thresholds. Execution logger with step-by-step tracking. CCT migration tools for safe cross-environment JetEngine data operations. Orchestration tools for multi-step workflows.
๐ JetBooking/JetAppointment Integration (8 tools). Adapter layer for Crocoblock booking and appointment plugins. 8 new tools + 4 enhanced calendar tools with booking/appointment awareness.
๐ง Moonshot AI (Kimi) & Z.AI (GLM) Provider Parity. Both providers upgraded to full DeepSeek-level chat client capabilities โ streaming, tool use, token tracking. ZAI client + baseten service in DI container. Provider count now 15 first-class.
๐ Unified Sync Log Manager. Per-item audit trail across EZuite, FlowHub, and Shopify sync toolkits. Sync history with timestamps, status, and error tracking. Status dashboards on admin pages.
๐๏ธ Tool Presets Auto-Select & Chips Bar. Selected tools display as clickable chips with +N overflow toggle. Tool payload cap raised from 50 to 100 tools per assistant.
๐ HTTrack Cache & Place-to-Service Bridge. HTML mirror import now supports HTTrack cache directories. Auto-creates bookable services during batch place import. URL backfill for mirrors without hts-cache.
๐ FlowHub Per-Connection Overview. Remote Sites connection selector on FlowHub config tab. Per-connection sync controls. Proxy support via http_api_curl hook.
๐ Web Search 429 Retry. Exponential backoff for rate-limited search requests.
๐ 45+ Bug Fixes. CCT module API mismatches across EZuite/FlowHub/Shopify (canonical Module.instance/Factory/ItemHandler). EZuite sync (missing return, field mapping, connections, CCT registration). FlowHub sync (silent failure, proxy persistence, auth headers, null cct, dry-run). Shopify sync (Catalog API guard, CCT registration lifecycle). Duplicate column errors in ensure_columns. SQLite meta cache explosion. masterminds/html5 case collision. Base-version guard blocking toolkits. Tool registry fatal guards. HTTrack import (URL resolution, hex filenames, subdirectory content, mirror detection). Necessity Gate request context crash. Auto-select compute timeout. Place-to-Service bridge collision.
๐ Documentation. Abilities registration plan (~1,000 tools as WordPress Abilities). Laravel-scale deployment architecture proposal. WP.org submission prep. Agent context sync.
โจ What's New at a Glance (v1.1.35)
๐ช FlowHub Inventory Sync Pro Toolkit. 6-tool cannabis dispensary management: products, inventory, locations, sync, analytics, alerts. P1 proxy support via http_api_curl hook. P2 CCT auto-registration in JetEngine custom content type tables. Auth, decryption, location_id, and null-guard fixes (PRs #5500, #5501, #5502, #5503, #5507, #5510). Admin UI toggle on Features tab.
๐ Shopify Sync Pro Toolkit. 5-tool bi-directional e-commerce sync: products, orders, inventory, analytics, settings. Connection resolver trait. Dashboard widget with sync status and recent activity. Tool reference docs at
docs/tools/shopify-sync-toolkit.md(PR #5502).๐ก๏ธ Necessity Gate Layer J. Pre-execution safety layer that scores tool calls by irreversibility risk. Write operations (create/update/delete) assigned risk scores by resource type. Safety profile trait with clean autoload. Request context crash fix.
๐๏ธ Local Voice Embedded STT. Three pluggable browser-side speech-to-text backends: Web Speech API, Whisper.cpp (WASM), Vosk (WASM). Offline-first โ no server dependency. Auto-detection based on browser capabilities (PR #5498).
๐ Remote Site Administrator Blueprint. 22-tool assistant blueprint in Site Creator toolkit for full remote/local WP/WooCommerce management with JetEngine, JetFormBuilder, and REST API control. Auto-discovered by Unified Blueprints page.
๐ฆ Places & Calendar Bulk Import. Batch import tools for Places and Calendar Booking toolkits โ import multiple records in a single call (PR #5509).
๐ป CLI site-import Subcommand. Multi-phase HTML mirror import for migrating static sites into WordPress โ page structure extraction, content mapping, media sideloading.
๐ค Voice Realtime Auto-Detect. WebRTC/WebSocket auto-selection, duplicate message prevention, VAD threshold improvements (PR #5508).
๐ง Remote Connections Fixes. WordPress case handling normalized. FlowHub and Printful credential storage fixed (at-rest encryption). Printful connection type added (PR #5499).
๐ 7 Bug Fixes. Token-scoped assistant resolution (PR #5497), user_id empty fallback (PR #5495), credential token mapping (PR #5493), post type name lengths (PR #5484), OpenAI image deprecation cleanup (PRs #5489-#5491).
๐ Documentation. GPT-Realtime-2 upgrade proposal + 1,166-line implementation plan. FastAPI porting implementation plan (PR #5467).
๐งน Housekeeping. Stale build artifacts and toolkit-addons directory removed.
๐ WP 7.0 Connectors Credential Integration. Credential_Resolver now integrated into all 17 AI client
get_api_key()methods. Fallback chain: WP 7.0 Connectors โ plugin settings โ env vars โ PHP constants. Credential source badges and WP 7.0 Connectors hints rendered in admin settings UI. All 13 provider API key field descriptions updated. Provider diagnostics show key source column. Settings health check counts credentials via resolver.๐งฉ nvoos-graphify v1.0.0. Standalone nvoos-graphify plugin released at v1.0.0 (Plugin Check compliant). nvoos-graphify-ai released at v1.0.0-dev. Fixed critical
->prepare()spread-operator bug inDb::listNodes(). Renamedvectorcolumn โembedding_vectorto avoid MariaDB/MySQL reserved-word conflict. Fixed snake_caseโcamelCase method calls across tools, controllers, and cross-plugin integrations.๐ก๏ธ Security Dependencies. guzzlehttp/guzzle 7.10.0 โ 7.12.1 (CVE-2026-55568, CVE-2026-55767). guzzlehttp/psr7 2.11.0 โ 2.12.1 (CVE-2026-55766). guzzlehttp/promises 2.3.0 โ 2.5.0. undici npm override tightened
>=7.28.0โ>=8.5.0.๐ npm Security. 29 alerts resolved across 14 packages: undici (TLS bypass CVE-2026-9697, cache info CVE-2026-9678), http-proxy-middleware (CRLF injection CVE-2026-55603), nodemailer (GHSA-p6gq-j5cr-w38f), webpack-dev-server (HMR CVE-2026-9595), dompurify (GHSA-cmwh-pvxp-8882). Fixed critical duplicate
overrideskey in rootpackage.json.๐ชฒ Bug Fixes. Fixed missing
-pro-in WP All Import/Export require_once paths causing fatal errors when those Pro tools load. Fixed fragile@file_get_contents()warning suppression in tool status label loader โ replaced with explicitset_error_handler('__return_true')to prevent leaked warnings from corrupting MCP JSON-RPC HTTP responses.๐ฆ Dependencies. 15 Dependabot bumps across Composer, npm (stripe, zod, p-queue, csv-parse, react-query, puppeteer, vitest, wrangler, eslint-plugin, workers-types, types/node), and GitHub Actions (codecov 4โ7, action-gh-release 2โ3).
๐งน Housekeeping. Stale 1.1.31 and 1.1.32 build zips removed. SPA addon ZIPs rebuilt with updated security overrides.
โจ What's New at a Glance (v1.1.32)
๐ Content Format Templates & Featured Images. Content Format Template CPT with user-editable blog templates. Content Template Engine generates Anthropic-optimised AI prompts. Featured Image Service with 3-provider fallback (DALL-E โ Gemini โ Cloudflare) and 5 image styles. Provider image settings now respected instead of hardcoded defaults.
๐ฌ Result Delivery Pipeline. 1,056-line service routes schedule results to 8 channels (email, Slack, Discord, Telegram, SMS, Paper Store, WordPress post, webhook). Both success and failure paths now deliver โ previously only failures were surfaced.
๐ ECA Document Generation. ECA Consolidate & Add page with document generation tools.
๐ชฒ Duplicate Posts Fixed. WordPress delivery channel removed from
weekly_blog_post_writerandweekly_blog_topic_researchpresets. Systemic guard skips WordPress delivery when AI tool calls already includecreate_postorsave_post.โฑ๏ธ 6 Provider Clients Timeout Fix. DeepSeek, Baseten, DigitalOcean, OpenRouter, Kimi, and Cloudflare clients now respect the global
request_timeoutsetting instead of hardcoding 60 seconds.๐ง Schedule Trigger Stability. Trigger crash on
rest_do_request()fixed with try/catch + pre-flight REST check. Result delivery sanitizer preserveschannelswrapper so edit modal shows saved values. AJAX handler captures PHP warnings that corrupt JSON.๐ Paper Store Delete Fix. Hidden inputs added to delete confirmation form so
handle_delete_record()receives required POST fields.๐งช npm CI & Jest Resilience. Babel ESM override pinned for Node 18/20 compatibility. Jest config probes for setup files at load time with graceful fallback. npm ci lockfile sync for 5 addons.
๐ฆ Dependencies. 14 safe Dependabot bumps. 8 npm audit CVEs (nodemailer, tar, tar-fs). phpspreadsheet 5.7.0 โ 5.8.0.
โจ What's New at a Glance (v1.1.31)
๐ฌ Media Command Center. Top-level NV Media admin menu with command center for media templates, presets, and blueprints.
๐ฌ Pro SPA v2 โ Rich Rendering & Scoping. Rich markdown rendering, per-assistant scoping, agent selector dropdown. Conversations primary, threads read-only. Version 2.0.1.
๐งฐ 34 Workflow Preset Tools. All missing workflow presets implemented across 10 toolkits. Full PHPCS compliance and test suite for 36 tools.
๐ npm Audit CVEs Resolved. 12 CVEs fixed: vite, launch-editor, markdown-it, ws, js-yaml, form-data, hono, dompurify, babel, opentelemetry, joi.
๐จ Gemini 3.1 Flash Image. Default Gemini image model upgraded to
gemini-3.1-flash-image.๐ผ Media Toolkit Blueprints & Presets. Blueprints and scheduler presets synced to Data Management page.
โก OpenAI/DeepSeek stream_options. Streaming usage payloads now include proper
stream_optionsfor accurate usage tracking.๐ฐ Agentic-Loop Cost Tracking. Tool result costs computed from tokens when not explicitly provided. Missing provider pricing added.
๐ก๏ธ Vite CVEs. vite ^8.0.16 for CVE-2026-53571 (server.fs.deny bypass) and CVE-2026-53632 (NTLMv2 disclosure).
๐งน 1,658 PHPCS Lint Fixes. Across base + pro addon (44 toolkits).
๐ง CI Disk Space. Free disk space step added to all build workflows.
โจ What's New at a Glance (v1.1.30)
๐ฌ Chat SPA Phase 8 โ Message Actions. Edit, delete, regenerate, copy, and content enrichment cards on every assistant message. Conversations sidebar with assistant scoping. Auto-create thread on first message.
๐ PM Toolkit Enhancement Phase AโD. Shared engine powering Command Center dashboard with real-time task visibility. Work Ingestion panel. 28 new AI tools for task management, resource allocation, timeline generation, and reporting.
๐ข CRM Toolkit โ Duplicates & Hygiene. Duplicate detection engine with safe one-click merge. Email hygiene module: domain reputation classification, exclusion/priority lists, auto-pruning. Top Customers/Clients analytics. LinkedIn & Upwork external sourcing.
๐ฅง DietPi Pro Toolkit Phases 0โ3. 19+ tools for server management: system info, package/service control, backup/restore, storage, provisioning, SSH proxy. Registered as MCP server.
๐ก๏ธ Layer I Guardrails โ Jailbreak Prevention. Stay-on-target guardrails blocking prompt-injection and role-change attacks. Configurable per-assistant via LLM Harness metabox.
๐ช Context Window Management. Pre-flight validation across all 13 AI providers. tiktoken integration, estimator metabox, token-budget tool capping, chat parity drift detection.
๐ WP 7.0 Connectors API Bridge. Forward-compatible provider credential bridge. Classes load unconditionally on WP < 7.0.
๐ง Chat Transcript & Agent Memory Retention. Configurable TTL-based transcript cleanup (base). Agent memory lifecycle management with pruning and retention windows (Pro).
โก Pro Toolkit Optimizations Phase 1โ3. Performance optimization across 6 Pro toolkits with autoload control, caching, and lazy loading.
๐ OAuth & API Disconnect Buttons. One-click disconnect for OAuth and API connections with automatic token clearing.
๐ฌ LibreChat Addon. New standalone addon with code interpreter, speech-to-text/text-to-speech, and web search reranker.
๐ชฒ 30+ Bug Fixes. SPA reliability sweep (thread endpoints, router context, event serialization). Agentic loop tool result persistence. CPT slug limits. Security CVEs (guzzlehttp/psr7, shell-quote, esbuild).
โจ What's New at a Glance (v1.1.29)
๐ง Chat Bubble Assistant Dropdown. Settings UX fixed:
chat_bubble_assistant_idchanged from manual ID input to proper assistant<select>dropdown.๐ช Context-Window Pre-Flight Validation. Added to all AI provider clients with shared
validate_context_window()helper, tiktoken integration, and estimator metabox.โก OpenAI SSE Streaming Fix.
stream_optionspayload flag corrected so OpenAI real-time SSE streaming triggers properly.๐ Schedule Preset Data Mismatches. Fixed presets losing configuration data after save. Improved error logging for preset operations.
๐งน Playbook Orphan Cleanup & Batching. Fixed orphan accumulation and sync timeouts with configurable chunk size batching.
๐ Stale Provider Validation Lists. Provider checks moved to dynamic discovery instead of hardcoded arrays, fixing DeepSeek rejection.
๐ CRM Activity Titles, Due Dates & Block API v3. Activity post titles, recurring due dates, and admin blocks migrated to WordPress Block API v3.
๐ฏ OpenAI-Compatible Client โ DeepSeek Parity. OpenRouter, Baseten, Kimi, DigitalOcean, NVIDIA NIM clients upgraded to DeepSeek parity.
๐ค Voice & Embedded LLM Missing Assets. Missing
.min.jsfiles added for voice recording/transcription and embedded LLM worker scripts.๐ชฒ 25+ Additional Fixes. Chat config messagesEndpoint, debug console, OOS bridge fatal error, embedding service WP_Error, SSE header warnings, memory cookie nonce, graphify content leak, model limits sync, shell-quote CVE-2026-9277, and more.
๐งช Tests. Chat transcript REST controller tests improved from ~4% to 87% pass rate.
โจ What's New at a Glance (v1.1.28)
๐ข CRM Phase C Complete. IMAP email polling, Twilio SMS webhook, Meta WhatsApp webhook, and Gmail OAuth bridge for multichannel inbound ingestion โ all triaged through CRM Classifier and routed to the Workflow Command Center.
๐ฅ Customer CPT + Customer 360. 5 CRUD tools for
mcp_ai_customerCPT. Customer Research & Add page with Customer 360 dashboard. Lead-to-customer conversion with deal promotion.๐ซ Support Ticket Module โ 10 AI Tools + SLA. Full ticket lifecycle: create, get, update, list, classify, escalate, resolve, reopen, merge, SLA report. Ticket automation, SLA breach detection via cron, email notifications, and optional Zendesk sync.
๐ TF-IDF + BM25 Relevance Search. Dual-algorithm relevance ranking across CRM, healthcare, and base content search tools. Shared traits in both Base and Pro.
๐ง Transformer-Inspired Attention Routing. QKV multi-head attention (5 heads: semantic, capability, recency, dependency, risk) for semantic tool selection. Sliding-window conversation compressor. Persistent tool embedding store. RRF fusion with harness scoring.
๐ Funiq Bridge Addon. Payload-to-WordPress bridge with React admin SPA, REST controllers, transformers, post types, and taxonomies.
๐ธ๏ธ NVOOS Graphify Ecosystem. Three standalone plugins:
nvoos-graphify(visual knowledge graph, 14 tools),nvoos-graphify-ai(13 providers, streaming chat, RAG, embeddings),nvoos-graphify-ai-platform(Agents, A2A, ACP, Blueprints, Federation, Harness, Measurement, Professions, Skills, Slash Commands). Framework-agnosticlib/coreandlib/wordpress-adapterpackages.๐๏ธ NV Platform AI Addon. Top-level admin dashboard + CPTs (Project, Resource, Template).
๐ฌ Automated Demo Video Pipeline (Phases 1โ3). Scripted scene recording, AI voiceover generation, automated video assembly.
๐ก๏ธ CRM Lead/Deal Enhancements. Enriched lead/company tables, dedicated Leads tab, data completeness KPI. Lead CPT admin expanded with contact details and remote channel link.
๐ Documentation & Unix Theory. Folder READMEs for new CRM subdirectories (
customers/,inbound/,support/). Compliance check errors inincludes/data/andaddons/pro/includes/traits/READMEs resolved. CRM enhancement plan updated.
โจ What's New at a Glance (v1.1.27)
โก Real-Time SSE Streaming. Real-time streaming enabled for OpenAI, DeepSeek, and all OpenAI-compatible providers. "Disable Native Streaming" control in Settings.
๐งฐ 35 New OOS Core Tools. Data tools (GetPostTaxonomies, CountPosts, GetPostMeta, TruncateText, MergeArrays), format tools (FormatDate, TimeAgo, ParseCsv, MathEval, ColorConvert), infrastructure (EventDispatcher, Queue), and cache management tools.
๐ธ Extended Cognition Vision Recognition. Visual product/brand recognition with camera viewfinder UI, detection overlays, and consent gate.
๐ง JetFormBuilder Submission Tools โ 8 Fixes. Empty results for non-admin users, form discovery pipeline, PHPCS warnings, REST route matching, form-type auto-detection, and plugin detection all fixed.
๐ฏ Graphify Tools Capability Compliance. Missing trait and explicit
get_required_capability()added to all Graphify tools.๐ค DeepSeek Agentic Tool Handling. Tool message filtering and payload normalisation for agentic multi-turn workflows.
๐ Docs Fixes. Broken links after Unix-theory reorganization resolved.
๐ฐ June 2026 Model Pricing. All 13 provider pricing updated.
๐ Plugin Restructuring Proposals v3.0. Graphify-centric architecture spec and roadmap.
๐ก๏ธ Pro Toolkits Security Audit. 9 HIGH-severity security findings fixed.
๐ Reviewer Onboarding Docs. Complete reviewer documentation suite (
docs/project/FOR_REVIEWERS.md).๐ณ Docker Dev Environments. WordPress, Laravel, and Craft CMS Docker environments all fixed.
๐งช Test Infrastructure. 95% of PHPUnit failures resolved across base, pro, and addon test suites.
๐ง Infrastructure Fixes. TCPDF autoloader fix, Pro vendor files committed, puppeteer detection path fix, shallow clone recommendation.
โจ What's New at a Glance (v1.1.25)
๐งฉ Unified Blueprint System. 55 pre-built AI assistant blueprints across 25 toolkits.
โ๏ธ Cloudways Pro Toolkit. 60 AI tools for server and application management via Cloudways API v2.
๐ข CRM Toolkit Phases AโE Complete. 70+ tools: lead management, multi-channel triage, sequences, command center, compliance.
๐ฌ Chat UI Enhancements. 7 features: profile card, stop generation, feedback, code copy, dark mode, prompts, search.
๐ Unix-Theory Tool Reorganisation Phase 4โ5 Complete.
๐ Pro Toolkit MCP Server Settings Pages. Phases AโC.
๐ฅ Aerlinn + Healthcare Blueprints.
๐ง Build Infrastructure Hardening.
โจ What's New at a Glance (v1.1.24)
๐งน Bug-Fix & Stabilisation Sweep. Paper Store Pro interface load order fix (deferred to
wp_mcp_ai_bootstrappedhook). Chat SPA duplicate-message and SSE protocol-mismatch fixes. Markdown rendering enabled in Chat SPA responses.๐ก๏ธ Skill Manager Canonical Envelope โ Unix Theory P0/P1 Refinement. Skill manager now returns
WP_Erroron failure instead of the legacyarray('success' => false, ...)pattern. Skills sync endpoint added for idempotent import/export. YAML frontmatter parsing hardened against colons in description fields.๐ Assistant Tool Presets Coverage. 24 missing tools added to assistant creation presets. Out-of-date tests fixed.
๐ CVE Patches.
tmpbumped to >=0.2.6 andsymfony/cacheto ^6.4.40 to resolve upstream CVEs. Composer vendor state committed.๐๏ธ Paper Store Admin CRUD. Full CRUD admin UI for Paper Store collections and records under Assistants menu, matching Skills admin convention.
๐ฅ๏ธ CLI Coverage Enhancements. Comprehensive WP-CLI command coverage improvements across the plugin toolchain.
๐ Folder README Convention โ Unix Theory P7. Folder READMEs added for every PHP-bearing subdirectory across
includes/andaddons/pro/includes/. Agent context docs (CLAUDE.md,AGENTS.md) synced with recent features.๐ง Build & CI.
build-spa-addonsGitHub Actions workflow added. Missing SPA addon ZIPs restored. All SPA bundles rebuilt.
Privacy & Terms Notice: This plugin connects to external AI services. Review each provider's policies:
Ollama: Self-hosted (no external data transmission)
LM Studio: Self-hosted (no external data transmission)
See the complete External Services Reference for all 20 services.
The plugin works standalone with ~303 base tools and optionally extends through the Pro addon, which adds ~1,263 Pro tools for advanced integrations (WooCommerce, JetEngine, social media APIs, GitHub, Google services โ including Google Calendar and the new Gmail/Drive read tools โ Shopify, QuickBooks Desktop, Yahoo Fantasy Sports, ESPN Fantasy, ECA management, CRE Debt & Securitization, Cloudways server management, CRM lead/deal/customer lifecycle, support ticket management, multichannel inbound/outbound messaging, Composio Connect, vision analysis object counting) and exec-based tools (FFmpeg, WP-CLI, Python rembg, Jukebox), bringing the total to ~1,566 built-in tools (~303 base + ~1,263 Pro; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative).
Note on Tool Count: Tools include base WordPress operations, content management, media generation, research capabilities, and optional third-party integrations. The base version (~303 tools) works standalone. The full version requires the Pro addon and provides ~1,566 total tools including specialized toolkits for e-commerce, social media, analytics, document generation, vehicle estimation, image validation, JetEngine MCP, A2A agent delegation, CRE Debt & Securitization, Cloudways infrastructure management, CRM lead/deal/customer lifecycle + support tickets + multichannel, MCP Apps, Composio Connect, vision analysis, and more. Live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative.
Addon Ecosystem: NV oOS ships a growing family of 27 installable addons: Pro (addons/pro/ โ ~1,247 additional tools), Chat SPA (addons/chat-spa/ โ React chat replacement), Docs Hub (addons/docs-hub/ โ in-site documentation SPA), SaaS Controller + Cloud Worker (addons/saas-controller/ + addons/cloud-worker/ โ NV oOS Cloud control plane), Cloudways Dashboard (addons/cloudways-dashboard/ โ Cloudways server management), Toolkit Shell / Canvas / Canvas Toolkit / Document Editor / Media Studio (addons/toolkit-shell/ etc. โ Toolkit SPA Blueprint Tier AโD), Media Worker (addons/media-worker/ โ Docker-based Node.js media sidecar, v3.2.0: multi-tenant shared worker mode, per-site provider keys, worker routing with local fallbacks, native /api/crawl/* endpoints + Crawl4AI facade), Graphify (addons/graphify/ โ knowledge graph), Comic Reader (addons/comic-reader/ โ CBR/CBZ/CB7/CBT reader), Funiq Bridge (addons/funiq-bridge/ โ Payload-to-WordPress bridge with React SPA), Fleet Operator (addons/fleet-operator/ โ scoped op_ operator credentials for MCP/A2A supervisor agents like Hermes), LibreChat (addons/librechat/ โ code interpreter, speech, web search reranker), Schedule Anything Platform + SPA (addons/schedule-anything-platform/ + addons/schedule-anything-spa/ โ SaaS booking with Stripe), Tenant Router (addons/tenant-router/ โ multi-tenant routing), Page Agent (addons/page-agent/ โ AI-powered browser page control copilot), Checkout API (addons/checkout-api/ โ vendor-side Stripe checkout/licensing service for premium addons), Algorave, Cornerstone3D, Crocoblock DS, Embedded, Fantasy Football. Separate standalone plugins: NVOOS Content Graph (plugins/nvoos-content-graph/ โ visual knowledge graph), NVOOS Content Graph AI (plugins/nvoos-content-graph-ai/ โ AI providers + chat + RAG), NVOOS Content Graph AI Platform (plugins/nvoos-content-graph-ai-platform/ โ agents, A2A, blueprints, skills). See docs/developer/addons/toolkit-spa-blueprint.md for the blueprint all SPA addons follow.
๐ฏ Mission: Modernizing Small to Medium Business Websites
NV oOS is specifically designed to help small to medium-sized businesses fast-track their outdated, stale, or insecure company websites to modern technology standardsโwithout the need to add yet another wrapper around API calls. Instead, we're trying to peel back decades of API wrappers with the help of AI, providing:
Direct AI Integration - No middleware required. Connect directly to OpenAI, Gemini, Anthropic, Hugging Face, Cloudflare Worker AI, Ollama, LM Studio, OpenRouter, and DeepSeek without custom development
Security-First Architecture - Built-in protection against nefarious usage with active monitoring and prevention systems
Enterprise-Grade Features - Access to capabilities typically requiring expensive custom development
Compliance & Audit Tools - Comprehensive logging, rate limiting, and usage tracking built-in
Zero Technical Debt - Modern codebase following WordPress standards, ready for current technology stacks
๐ก๏ธ Active Security Monitoring
NV oOS actively prevents and monitors against nefarious behavior. The plugin includes:
Nefarious Usage Monitor - Real-time detection of suspicious patterns and automatic emergency shutdown capabilitiesใF:includes/class-wp-mcp-ai-nefarious-usage-monitor.phpโ L1-L676ใ
Root Security Key - Optional emergency authentication layer to prevent unauthorized reactivation after security incidentsใF:docs/features/security/root-security-key.mdโ L1-L511ใ
Granular Capability Controls - Every tool and API endpoint enforces WordPress capabilities to prevent unauthorized access
Rate Limiting - Built-in protection against abuse with configurable limits per user, model, and time period
Comprehensive Audit Logging - Track all API calls, tool executions, and security events for compliance and forensic analysis
Input Sanitization & Output Escaping - All user input sanitized, all output escaped following WordPress security best practices
This is not a tool for circumventing security or promoting bad practices. Every feature is designed with security, transparency, and responsible AI usage as core principles. The plugin actively works to stop and prevent misuse before it happens.
Latest audit: See docs/operations/compliance/SECURITY_AUDIT_2026_04.md โ the published summary of the April 2026 security & compliance code review (no Critical findings; 5 High items, 3 Fixed and 2 Partially Fixed). Full deliverables under docs/project/audits/2026-04/.
WordPress.org compliance hardening (May 9, 2026): docs/operations/compliance/WORDPRESS_ORG_COMPLIANCE_2026_05_09.md โ findings B3, B8, B10, B13, and production vendor remap all resolved.
โ ๏ธ Warranty & Safe Use
We make every effort to keep NV oOS safe and secure โ but by design, it can be destructive and resource-intensive when not properly configured.
NV oOS grants AI assistants access to powerful WordPress operations. The same capability that automates real work can cause irreversible harm if misconfigured:
Destructive tools โ bulk content deletion, user management, file writes, mass email, WP-CLI, direct database operations
API billing exposure โ uncapped AI provider calls can exhaust quotas and trigger unexpected charges
Server resource exhaustion โ concurrent agentic loops and SSE streams can saturate CPU/memory on shared hosting
Before going live: test on staging, take verified backups, apply least-privilege tool permissions, enable rate limiting, and review the system prompt of every public-facing assistant.
๐ Full details: WARRANTY.md โ security commitment, "AS IS" disclaimer, destructive-operations table, resource-consumption guide, and mitigation checklist aligned with OWASP, NIST SP 800-53, ISO/IEC 27001, and the WordPress Plugin Developer Handbook.
Patent Pending
NV oOS is the subject of a pending patent application for its novel System and Method for Dynamic AI Orchestration Layer with Real-Time Capability Gating and Resource Budgeting.
Application Number: 19/410,504
The patent covers NV oOS's innovative approach to implementing sophisticated AI orchestration in WordPress's request-based PHP architectureโa platform not designed for real-time streaming, asynchronous operations, or persistent state management. This technical achievement enables enterprise-grade AI capabilities on WordPress by recreating event-driven behavior within PHP's synchronous execution model.
Key Innovations Covered:
Dynamic resource budget allocation during streaming operations
Capability-based access control for AI tool execution
Registry-state-based scheduling in stateless environments
Metrics-driven budget adjustment for real-time optimization
Persistent-behavior illusion in request-based architectures
The orchestration layer makes NV oOS unique in the WordPress ecosystem by solving fundamental architectural limitations that prevent traditional WordPress plugins from supporting advanced AI features. See the System Architecture section below for technical details on how these innovations work together.
๐ System Architecture
NV oOS implements a comprehensive orchestration layer for managing AI operations during real-time streaming events. The system architecture comprises:
15 language-model providers โ OpenAI, Gemini, Anthropic, DeepSeek, OpenRouter, Baseten, Kimi (Moonshot), Z.AI (GLM), DigitalOcean, NVIDIA NIM, Cloudflare Worker AI, Ollama, LM Studio, Hugging Face, Flowhub
~1,566 tool classes (~303 base + ~1,263 Pro; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative) registered through a singleton Tool Registry36 REST controllers (16 base + 20 pro) under the
mcp-ai/v1namespace64 service classes powering orchestration, budgets, and workflows
5 authentication methods โ WordPress nonce, assistant credentials, mesh keys, Auth0 JWT, guest tokens
Toolkit MCP servers โ per-toolkit JSON-RPC 2.0 servers exposed under
/wp-json/mcp-ai-pro/v1/mcp/{slug}; discoverable at/.well-known/mcp8 inline-async-tick consumers โ cooperative tick-lock pattern eliminates WP-Cron startup latency for background jobs (transcript mining, async tool executor, SaaS Apply, Crawl4AI, Docs Hub rebuild, Graphify reindex, Harness eval, Gemini Veo polling)
7 LLM Harness layers (+ 1 Pro) โ opt-in epistemic layers AโH activated per-assistant via the LLM Harness metabox
Orchestration Phases 1โ7 โ HITL approval queue, prompt-injection detector, structured output, OTel exporter, DAG builder, durable runs, triggers/webhooks, sub-agents
๐ For a detailed explanation of how NV oOS extends standard SSE and MCP protocols with novel orchestration features, see ORCHESTRATION-LAYER-ARCHITECTURE.md
Core Orchestration Layer: Overcoming PHP's Limitations
Critical Context: Most real-time AI streaming systems are built with Node.js, Python FastAPI, or Go โ platforms designed for asynchronous, event-driven operations. These platforms natively support:
Long-lived connections and persistent state
Non-blocking I/O and parallel execution
Event loops and asynchronous callbacks
WebSocket protocols and SSE streaming
NV oOS achieves the same capabilities in PHP/WordPress โ an environment fundamentally not designed for these patterns โ through a sophisticated orchestration layer that creates a "persistent-behavior illusion":
Real-Time Budget Enforcement - Monitors token/memory usage during streaming, prevents exhaustion through predictive allocation
Capability-Based Tool Gating - WordPress role-based access control for AI tool execution
Predictive Optimization - Analyzes usage patterns to prevent resource overruns before they occur
Distributed Orchestration - Multi-provider support with policy-aware routing
Auditability & Compliance - Complete governance layer with logging and rate limiting
Cron-Based Task Orchestration - Extends orchestration to async operations with budget inheritance
Multi-Agent Orchestration Enhancement (DeepSeek V4-Inspired)
Added: January 2026 (v1.1.0)
Building upon the core orchestration layer, NV oOS now includes a sophisticated multi-agent coordination framework inspired by DeepSeek V4's orchestration patterns:
Key Components:
Agent Role System - Four specialized roles (Planner, Executor, Critic, Specialist) with role-specific capabilities
Team Composition - Automated team assembly based on task requirements and profession expertise
Coordinated Workflows - Multi-step workflows with agent delegation, result aggregation, and validation
Team CPT Integration - Persistent team configurations with orchestration modes (single/sequential/parallel/swarm)
Profession-Based Discovery - 296 professions auto-assigned agent roles via intelligent seeding across 17 knowledge bases
Example Multi-Agent Workflow:
// 1. Compose research team (planner + executors + critic)
$orchestrator = new WP_MCP_AI_Agent_Team_Orchestrator();
$team = $orchestrator->compose_team( array( 'task_type' => 'research' ) );
// 2. Execute coordinated workflow
// Planner decomposes task โ Executors research subtasks โ
// Communication service aggregates โ Critic validates quality
$result = $orchestrator->execute_team_workflow( $team, $task, $context );Documentation:
See Multi-Agent Orchestration for complete technical details
See DEEPSEEK-V4-README.md for documentation suite overview
See DEEPSEEK-V4-USAGE-GUIDE.md for practical examples
Why This Architecture Is Novel: Overcoming PHP's Limitations
Event loops and background workers
PHP/WordPress, by contrast, is fundamentally request-based:
Every HTTP request spawns a new process that dies after responding
I/O operations block execution
No persistent memory between requests
No native event loop or async coordination
NV oOS solves this by implementing an orchestration layer that creates a "persistent-behavior illusion" โ effectively recreating Node.js's event loop behavior within WordPress's synchronous, request-based architecture. This architectural compensation is the system's core technical innovation:
PHP Limitation | NV oOS Solution |
No persistent state | Registry & policy engine maintain state via database/cache |
No event loop | Cron Manager extends orchestration across time-shifted operations |
Blocking I/O | Predictive budget allocator prevents blocking operations |
Request-based lifecycle | SSE controller implements streaming within request boundaries |
No background workers | WordPress cron system simulates async job processing |
This makes NV oOS patent-worthy as a technical workaround โ it achieves sophisticated AI orchestration in an environment specifically not designed for such patterns. See ORCHESTRATION-LAYER-ARCHITECTURE.md for the complete technical analysis.
Computer-Implemented Resource Management
The system operates as a computer-implemented method executing on a processor with memory, performing:
Dynamic Resource Budget Allocation: The orchestration layer dynamically allocates token and memory budgets to tool execution requests based on real-time system capacity and operation requirements. The
WP_MCP_AI_Resource_Managercontinuously monitors server resources (PHP memory limits, execution time constraints) and automatically adjusts operational parameters.Capability-Based Access Control: Tool execution endpoints enforce granular capability-based access controls. Each tool in the registry declares required WordPress capabilities, and the REST API controller validates user permissions before allowing execution. This ensures secure, policy-driven access to all operations.
Registry-State-Based Scheduling: The
WP_MCP_AI_Tool_Registrymaintains tool availability state and schedules execution based on policy constraints. Tools are loaded conditionally based on dependency availability, and execution is scheduled according to assistant configuration and user permissions.Metrics-Driven Budget Adjustment: The system continuously monitors execution metrics (memory usage, API response times, token consumption) and adjusts resource budgets in response to prevent resource exhaustion and reduce latency. The
WP_MCP_AI_Token_Budget_Managerimplements safety margins and dynamic chunking to prevent API limit overruns.
System Components
The system comprises a processor and memory storing instructions that:
Monitor real-time resource availability through PHP runtime introspection
Enforce capability checks at REST endpoint boundaries
Schedule tool execution through a centralized registry
Adjust token and memory budgets based on detected system metrics
Maintain operation logs for audit and optimization
This architecture is embodied in non-transitory computer-readable media (PHP source files) that, when executed by a web server processor, cause the system to perform the complete resource management workflow. The implementation prioritizes stability, security, and efficient resource utilization across diverse hosting environments.
Symfony Process Integration (December 2025)
NV oOS Pro addon integrates the Symfony Process component for secure external command execution. This modern framework replaces direct exec() calls in 6 Pro tools and 2 supporting services, providing:
Enhanced Security: Proper argument escaping and command validation
Timeout Management: Configurable timeouts with graceful handling
Better Error Handling: Comprehensive exception catching and WordPress-friendly error reporting
Process Control: Real-time output streaming and cancellation support
Migrated Tools & Services:
FFmpeg operations (video frame extraction, metadata reading)
Python rembg (background removal)
WP-CLI execution
Meta AI Jukebox (music generation)
Supporting services for video and audio processing
The Process Service (WP_MCP_AI_Process_Service) provides WordPress-friendly wrappers with WP_Error integration, making external process execution consistent with WordPress coding standards.ใF:includes/services/class-wp-mcp-ai-process-service.phpโ L1-L220ใใF:docs/history/2025/implementations/symfony-phases/SYMFONY_PHASE2B_PROCESS_INTEGRATION.mdโ L1-L100ใ
๐ Latest Updates (v1.1.71 โ September 2026)
September 5, 2026 โ Rate-Limit Unlock, September Model Catalog, Content Graph 1.0.4, Wave E2 Queue Layer
๐ Rate-Limit Unlock + Fixed-Window Timer โ PR #6322. The general REST request limiter (
check_rate_limit()) now uses fixed-window accounting ({count, first_seen}transient payload, TTL never extended past window end, legacy integer transients normalized on read) and returns the remaining time inretry_after. When the limit trips, the newwp_mcp_ai_rest_request_rate_limit_exceededaction makesWP_MCP_AI_Restriction_Registryflag arate_limitrestriction (scoperest, auto-release at window end) โ the block now appears in the Command Center Restrictions tab and Token Manager with the existing Lift button, and lifting deletes thewp_mcp_ai_rate_limit_user_{id}transient for a fresh window. Guest (IP-keyed) blocks are not user-attached and expire on their own (docs/features/security/user-restrictions.md).๐ง MemPalace Wing-Scope Fix + Post-K16 Singles โ PR #6327.
WP_MCP_AI_Tool_Wake_Up_Context::matches_wake_filters()enforceswing/roomexclusions (the Graphify graph anchors only boost scores โ they never excluded out-of-scope memories, leaking cross-wing memories into wing-scoped blocks). Test-only isolation from CI run 91942465749: transcript repository mock restored unconditionally, shared tool-registry instance restored untouched (tearDown wiped one-shot bootstrap tools like the Pro OKF tools), Site Health connectivity tests unset the other provider keys, transcript-mining logging resets the settings cache.๐ Checkout API Pipeline + Salt Fix โ PR #6315.
build/nvoos-checkout-api-v<version>.zipjoins the addon build,addons/checkout-api/testsjoins the main PHPUnit gate, and the build workflow gains atestsjob. Production fix: the token/crypto classes derivewp_salt( 'auth' ) . wp_salt( 'secure_auth' )instead of readingAUTH_KEY . SECURE_AUTH_KEYdirectly (latent fatal on salt-less installs).๐งญ September 2026 Model Catalog โ PR #6328. 217 โ 228 models (catalog version 2026.07.14 โ 2026.09.05): new gpt-5.6 family,
gpt-6-astrapreview,gpt-image-2,claude-opus-5,claude-fable-5.1,claude-mythos-5, gemini-3.6/3.7/3.8-flash,gemini-3.5-flash-lite,gemini-3.1-flash-image-preview,deepseek-v4-flash-vision-exp,kimi-k3,kimi-k2.7-code; retireddeepseek-chat/-reasoner/-coder(API retired 2026-07-24),gemini-3.1-flash(sunset 2026-09-01),imagen-4(shutdown 2026-08-17) with migration-map successors; pricing drift fixes (deepseek-v4-flash input 10ร, Claude Opus inputs $15 โ $5);gemini-2.5-flash-imagesunset 2026-10-02,claude-sonnet-4-6sunset cleared; defaultsgemini-3.6-flash/gpt-image-2/kimi-k3. ~45 derived files;lib/core/,lib/wordpress-adapter/, and the Content Graph AI plugin keep their own mirrored tracks.๐ Content Graph v1.0.4 Visual Experience โ PR #6318. Theme engine (one token registry, PHP/JS byte-identical, WCAG โฅ3:1 palettes), appearance settings tab, 24 SVG type glyphs, interactive legend/minimap/zoom cluster/fullscreen/keyboard,
GET /edgesREST route with relationship color families, export at 1โ3ร,[nvoos_graph]+ block parity attributes, three visual filters, and a checkout-fallback redirect to the vendor product page.๐ Content Graph AI Blocks + Settings Shell โ PRs #6316, #6317.
assistant-selector,tools-grid,knowledge-base,assistant-builderblocks (the Build Assistant Prompt tab embeds the tools grid + KB);SettingsValidator/AiSection/SettingsRegistrysettings shell (validate-then-sanitize, real validations on provider-selection + chat-settings).๐ Platform Wave E2 Queue Layer โ PRs #6319โ#6321, #6325.
AsyncJobQueue(newnvoos_content_graph_ai_platform/async_job_executorsfilter),QueueManager,JobQueueManager(atomicSELECT โฆ FOR UPDATE SKIP LOCKED),DeadLetterQueueโ byte-identical ports completing the platform queue pipeline; drive-by fix extractsAgentCapabilityBoundaryHooksto its own PSR-4 file (standalone fatal).๐ Connectors Links โ PR #6314. Providers-tab notice + API-key credential-source hint now use
admin_url( 'options-connectors.php' )(the core Connectors screen) instead of the unregisteredadmin.php?page=connectors.๐ New Coding-Time Skill โ PRs #6323, #6324.
.agents/skills/mcp-ai-wpoos-updates/codifies Track A (docs & release catch-up) + Track B (model catalog & config updates); skill count 53 โ 54; YAML frontmatter fix follow-up.๐ฆ Versioning โ bumped to 1.1.71 across all version-bearing files. Pro addon: 1.1.71. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.4 (was 1.0.3). nvoos-content-graph-ai: 1.0.4 (unchanged). nvoos-content-graph-ai-platform: 2.0.0 (unchanged). Checkout API: v0.1.0 (unchanged). Docs Hub addon: 0.4.2 (unchanged). Tool count: ~303 base + ~1,263 Pro (~1,566 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 27. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 54. Stale 1.1.68 + 1.1.69 build ZIPs removed.
๐ Latest Updates (v1.1.70 โ September 2026)
September 5, 2026 โ exec-Disabled Host Hardening + Fifth PHPUnit Repair Wave
๐ก๏ธ Shell-Call Hardening โ PR #6295. Disabled
exec/proc_openno longer fatals the Pro Packages / Document Generation / Image Production / Media pages or the OCR service:wp_mcp_ai_check_nodejs_available()/wp_mcp_ai_get_nodejs_version()(new,addons/pro/includes/npm-integration-filters.php) fall back toWP_MCP_AI_Process_Service; OCR routes throughis_cli_tool_available()/run_cli_command()with guardedproc_*calls;max( 0, (int) $value )replacesabsint()forassistant_id, time limits, and passing scores across seven CPT/settings pages.๐ Wave-5 Fixes โ PRs #6280, #6281, #6282, #6283, #6285, #6286, #6293. Transcript
display.attachmentspreserved (sanitizer kept the{url, label, downloadName, meta}shape) + model-awaremax_completion_tokenscaps (#6280); Pro dashboardget_monitoring_event_stats()accepts both slug styles (#6281); validatedweb_searchprofession tags (#6282); preset fixes โ phantomvalidate_contact_datastep removed, hook moved toschedule_data.hook(#6283); mesh URLs validated pre-sanitization (#6285); guest bucket for opt-in memory capture (#6286); curriculum exporter skips empty structures (#6293).๐ Wave-5 Fixes โ PRs #6296, #6298, #6300.
WP_MCP_AI_JetEngine_CCT::is_storage_available()physical-table probe + deleter/writer/tool gating +conversation_import_*preset additions (#6296); complexity routing restored โ enhanced client passes the explicit model only, falling back to the site default only when routing is disabled (#6298);JET_ENGINE_VERSIONrequirement on JetEngine gates, transactional-DDL-safecct_table_exists(), JFBid+ flat params, cachedwp_mcp_ai_pro_get_tool_map()feeding the token-manager listing (#6300).๐ Wave-5 Fixes โ PRs #6301, #6302, #6303, #6304, #6305. Auth0 audience validated structurally (identifiers, not endpoints โ the Auth0 domain keeps the SSRF guard) + GitHub OAuth
wp_mcp_ai_github_oauth_redirect_terminateseam (#6301); skill-pack slug normalization +wp_mcp_ai_skill_pack_installedfor empty packs + markup REST400annotations + filterablewp_mcp_ai_legacy_sse_enabled(#6302); clamp sanitizers +wp_mcp_ai_plugins_integration_redirect_terminateseam + section-ID/tab contract updates (#6303);is_elementor_editor_init()+static::is_available()(#6304); acting-userread_postchecks + positive-int user validation + Auth0 structural audience check (#6305).๐ Wave-5 Fixes โ PRs #6306, #6308, #6311.
timed-outtimeout needle + provider-prefix-stripped model limits (nvidia/nemotron-โฆโnemotron-3) + Ollama native tool-call preservation +css_to_xpath()predicates +published_date+wp_mcp_ai_missing_image(#6306); agentic*+token_db_optimizedallowlist events +started_at_mstrace durations (#6308); K16 โsanitize_key-stable webhook IDs with dotted event names, settings-repository blob fallback (request guard / security manager / destructive-ops gate now see dashboard-saved settings), acting-user chartunfiltered_html, social-publishpost_datereset, PSO keyword inflections, site-builder heading-tag allowlist, schema-verifierrequiredindependence (#6311).๐งช PHPUnit Repair Campaign, Wave 5 โ PRs #6280โ#6312 (~29 test-only). Clusters closed from two triage runs (
docs/developer/testing-docs/CI-TRIAGE-91006542428.md,CI-TRIAGE-91771001271.md): chat transcripts, charts/dashboards, professions/teams, presets/remote connections, Cloudflare, mesh, memory, CPT management, PayHere, Mubert, OpenAI Images, composer drift ร2, Content Graph AI, pro schedule AJAX, model routing, Gemini, JetEngine/Graphify stub isolation (tests/helpers/jetengine-stubs.php), OAuth/credentials, REST + skill packs (K15 upload isolation in #6312), admin/settings, Elementor, permission gates, HTTP/provider clients, orchestration budget, logging/events, K16 misc singles. Cluster board compacted in themcp-ai-wpoos-test-suiteskill (37 patterns unchanged).๐ฆ Versioning โ bumped to 1.1.70 across all version-bearing files. Pro addon: 1.1.70. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged). nvoos-content-graph-ai: 1.0.4 (unchanged). nvoos-content-graph-ai-platform: 2.0.0 (unchanged). Docs Hub addon: 0.4.2 (unchanged). Tool count: ~303 base + ~1,263 Pro (~1,566 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 27. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 53.
๐ Latest Updates (v1.1.69 โ September 2026)
September 4, 2026 โ Vision Analysis Toolkit, tagDiv Admin Compat, DeepSeek Schema Fix, ZipSlip Guard Revival
๐๏ธ Vision Analysis Toolkit โ PR #6267. New Pro toolkit in
addons/pro/includes/tools/vision-analysis/:analyze_image_objects(detection/vlm/hybrid modes,annotate=trueGD bounding-box copy as a media attachment) +WP_MCP_AI_HF_Vision_Inference_Service::count_objects(),WP_MCP_AI_Vision_Count_Normalizer,WP_MCP_AI_Vision_VLM_Client,WP_MCP_AI_Vision_Annotator, and the NV oOS โ Vision Analysis settings page (off by default, SSRF-guarded).bin/run-tests-docker.shnow composer-installs dev dependencies for production-only clones.๐ tagDiv Admin Compat & Metabox Crashes โ PRs #6266, #6278. SiteKit tools return string capability-flag arrays (the undefined
CAPABILITY_CAN_USE_IF_ADMINconstant killed the tools metabox atsitekit_get_adsenseon nugl.com); the sortable fallback prints its bundled copy whenevertd_wp_adminis enqueued (print-queue detection) atadmin_head+wp_print_footer_scriptspriority 1; the media script chain is forced as direct head tags from core-registered handles; tools metabox CSS enqueued onadmin_enqueue_scripts.๐ง DeepSeek Empty-Schema 400 โ PR #6272. Argument-less tools now emit
properties: {}across 29 files (Gmail/Drive list tools, Cloudways ร4, DietPi ร7,wait_for_user,okf_list_bundles, WebChat status, graphify, embedded abilities,ProfessionStatsTool, content-graph);LegacyToolAdapterpreserves object maps + upgrades empty arrays; scaffold template emitsnew stdClass().๐ ZipSlip Guard Revival โ PR #6270.
count( $zip )replaces the PHP 8.x-nonexistent$zip->num_filesin all five entry loops (OKF bundle manager, Comic/Media Consolidate pages, Skill Manager ร2) โ archive import rejects path traversal again (probe confirmed../evil.mdpreviously imported).๐ Fixes โ PRs #6265, #6271, #6274, #6277. Rate limiter accepts the dispatching request's HTTP method (internal dispatches classified by their real verb, GET/HEAD exempt) and the nefarious monitor uses its own namespaced counter so a shared counter can't halve the chat budget;
wp_mcp_ai_before_chat_requestsubscribers tolerate the legacy 2-arg emitter shape. Assistant edit screen:collect_prebuilt_shortcut_tasks()catches\Throwableper tool and coerces non-array filter results. Model catalog:gpt-4oโ 128k,gemini-2.0-flashback in the video-capable list,claude-sonnet-4-6/gpt-4orestored to active, two Qwen Hugging Face entries added. Settings save reads the cache-suspension state before suspending so it restores correctly โ WP 7.1 inline-async tick locks no longer jam after a settings save.๐งช PHPUnit Repair Campaign Continuation โ PRs #6260, #6262โ#6276. Fourth wave (~9 test-only PRs): #6260 count-tokens params, #6262 continuation seam, #6263 chat SSE handler, #6264 deterministic cache expiration, #6268 coverage manifest + slug integrity, #6269 incorrect-usage notices (9 suites), #6273 admin registration drift, #6275 subtab sanitizer routing, #6276 14 Veo suites. The
mcp-ai-wpoos-test-suiteskill grew to 37 patterns; the plugin skill documents the third rate-limit counter.๐ฆ Versioning โ bumped to 1.1.69 across all version-bearing files. Pro addon: 1.1.69. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged). nvoos-content-graph-ai: 1.0.4 (unchanged). nvoos-content-graph-ai-platform: 2.0.0 (unchanged). Docs Hub addon: 0.4.2 (unchanged). Tool count: ~303 base + ~1,263 Pro (~1,566 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 27. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 53.
๐ Latest Updates (v1.1.68 โ September 2026)
September 3, 2026 โ Pro SPA v2 Shortcode, Hermes Fleet Extensions, Stale-Nonce Self-Heal, Docs Hub 0.4.2, Provider Defaults
๐งฉ Pro SPA v2 Shortcode & Embedded Mode โ PR #6256.
[nvoos_pro_spa]embeds the Pro SPA v2 chat surface on the front end (chat-first embedded mode: threads, drawers, tool shortcuts, OKF drawer; router-free, no admin routes), with per-instancedata-configattributes and optional guest mode through the base guest-token machinery behind the "Allow Guest Access" setting. Proposal 033 +addons/pro/README.md.๐ฅ๏ธ Hermes Dashboard Fleet Extensions โ PR #6249. New
extensions/tree:nv-oos-fleetfleet monitoring + control plane (Python plugin API,sites.yamlinventory, dashboard bundle),backup-download,external-app-tab,mcp-tool-shortcutsWebUI extensions,install.sh, and backend smoke tests. Plans indocs/developer/integration/.๐ Stale REST Nonce Self-Heal โ PR #6225.
GET /mcp-ai/v1/session/noncemints a fresh session-bound nonce from the request's own auth cookie (nonce/capability-free by design,no-cache/no-store); the chat client retries failedrest_cookie_invalid_nonce403s instead of showing "Cookie check failed" on full-page-cached or long-lived SPA pages.docs/reference/api/rest-api.mdupdated.๐ Docs Hub 0.4.2 โ PRs #6246, #6253. Local-page
.mdlinks rewrite to#/slughash routes (anchors preserved); TOC slugs match github-slugger exactly (0 mismatches across ~63,000 headings); "Accept fix" computes targets relative to the source directory (case-preserving);../links validated with root-containment checks; broken-link entries carryslug/source_type+ skip reasons; sync/rebuild reports "Atomic swap failed" when the staging cache is unwritable; dead 404 route removed; the core emoji loader is disabled on docs-browser pages (its MutationObserver was crashing React's DOM). Addon bump 0.4.1 โ 0.4.2.๐ Provider Enable Defaults โ PR #6255. Fresh installs now disable OpenAI/Anthropic/Gemini by default; provider dropdowns list only enabled + credentialed providers (
get_available_providers()); the onboarding wizard auto-enables the provider whose key is entered; plugin + test-suite skills updated in-commit.๐ Fixes โ PRs #6226, #6232, #6233, #6239, #6242, #6243, #6244, #6250, #6258. Calendar granted-scopes URL corruption (sanitizer keeps space-delimited scope lists; legacy
%20grants normalized back to spaces); agent-identity resolver casts alias-table canonical IDs to int; token-budget catalog dedup (gpt-4.1,gemini-2.5-flash) + restoredwp_mcp_ai_model_tpm_limitfilter seam on the CCT โ catalog fallback path; assistant untrash restores the pre-trash status viawp_untrash_post_status(published assistants stay published, CCT sync resumes); tool presets gain the missing OKF enrich/router, Google Calendar, Gmail/Drive,composio_manage_accounts, andgit_inspect/git_changetools;wp_mcp_ai_seed_task_templatesAJAX action registered;fast-urioverride >=4.1.4 across root/Pro/SaaS npm trees; Tiptap pinned to 3.30.4 in canvas-toolkit + document-editor (mergeAttributes prototype pollution); jQuery UI sortable shim on post edit screens for third-party admin scripts.๐งช PHPUnit Repair Campaign Continuation โ PRs #6223โ#6257, #6259. Third wave (~21 test-only PRs: #6224, #6227โ#6231, #6234โ#6241, #6245, #6247, #6248, #6251, #6252, #6254, #6257 + CI alpha-log refresh #6223) kept the suite aligned with current contracts; the production fixes it carried are listed above, plus the late-merged
wp_mcp_ai_attachment_segment_providerfilter for providers without a remote file API (#6259).๐งน Housekeeping. Stale 1.1.67 build ZIPs removed from
build/,build/optional-components/,build/toolkit-addons/(27 files).๐ฆ Versioning โ bumped to 1.1.68 across all version-bearing files. Pro addon: 1.1.68. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged). nvoos-content-graph-ai: 1.0.4 (unchanged). nvoos-content-graph-ai-platform: 2.0.0 (unchanged). Docs Hub addon: 0.4.2 (bumped this window). Tool count: ~303 base + ~1,262 Pro (~1,565 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 27. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 53.
๐ Latest Updates (v1.1.67 โ September 2026)
September 1โ2, 2026 โ Content Graph Platform Extraction v2.0.0, Ecosystem Port Wave D + D-UI, Google Workspace Read Tools
๐งฉ Content Graph Platform Extraction โ PR #6123.
plugins/nvoos-content-graph-ai-platform/ships standalone at v2.0.0: Waves AโC + Blueprints (namespace-bridged admin UI, skill/slash-command/agent bridges, platform dashboard + settings registry, harnessToolRouterHarness), a 74-skill bundled-skills pack (data/bundled-skills/), knowledge base (data/knowledge-base/), and.github/workflows/phpunit-platform.yml. Plan:docs/project/plans/content-graph-platform-extraction-plan.md; gaps:MIGRATION-GAPS.md.๐งฑ Ecosystem Port Wave D + D-UI โ PR #6142. The additive Base+Pro โ Content Graph port lands the AI runtime in
nvoos-content-graph-aiโ chat runtime core (D1), providers beyond the 13 (D2), model management + analytics/token tracking (D3), security guards (D4), plus D-UI admin pages, chat blocks, Elementor widgets, guest tokens, agent memory, WP-CLI, chat compat route, MCP JSON-RPC controller โ with.github/workflows/phpunit-ai.yml. Content Graph AI bumps 1.0.3 โ 1.0.4. Tracker:docs/project/ecosystem-port-tracker.md.๐ง Google Workspace Gmail + Drive Read Tools โ PRs #6151, #6152. Six new Pro tools (Gmail:
get_gmail_message,get_gmail_thread,list_gmail_connections,modify_gmail_message; Drive:get_drive_file,list_drive_connections) with two new clients on the sharedincludes/google/foundation;search_gmail/search_driveupdated.๐งช PHPUnit Repair Campaign Continuation โ PRs #6114โ#6208, #6209โ#6222. ~100 cluster PRs (second wave) kept the suite green; production fixes carried: assistant-directory REST empty-title guard (#6141), null-safe tool-error reporting (#6186), LLM sanitization delegated to the validator (#6187),
display-metadata persistence (#6172), crawler job-contract hardening +wp_mcp_ai_crawl4ai_auto_spawn_cronfilter (#6124, #6125), create-post taxonomy guards (#6115), toolkit-registry live-singleton resolution (#6117), slash-command handler fixes (#6122, #6140), URL-encoded external-API queries (#6156), Veo 5-second floor (#6180), token-tier caching guards (#6178), credential-resolver cache invalidation (#6119), cache-helper option-cache eviction (#6134), settings dashboard/registry fixes (#6139, #6144), orchestration-dashboard menu (#6160), tool-multiplier visibility (#6189), content-format filter seams (#6203), CRM workflow-preset canonical schema (#6208), Pro Composer class-ambiguity rename (#6198), PM assistant metabox (#6174), profession seeder envelope (#6197), destructive-ops gate canonical settings read (#6151), WhatsApp webhook signature rejection without an app secret (#6192), Graphify/Content Graph HTTP 304 cached-body re-serve (#6161), Veo async-job completion ordering (#6211), orchestration-renderer token-budget display (#6213), Shopify Sync client-availability filter seam (#6215), slash-command workflow metrics guard (#6216) + parallel/conditional block rendering (#6218), Paper Store array-field query matching (#6222), systemic PHPUnit 11 / WP 7.1 env-compat fixes (#6196). Test-suite skill refreshed to 26 patterns (#6154).๐งน Housekeeping. Stale 1.1.66 build ZIPs +
.sha256removed; re-created 1.1.65 ZIPs re-removed.๐ฆ Versioning โ bumped to 1.1.67 across all version-bearing files. Pro addon: 1.1.67. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged). nvoos-content-graph-ai: 1.0.4 (bumped this window). nvoos-content-graph-ai-platform: 2.0.0 (new standalone). Tool count: ~303 base + ~1,262 Pro (~1,565 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 27. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 53.
๐ Latest Updates (v1.1.66 โ August 2026)
August 28โ31, 2026 โ PHPUnit Suite Repair Campaign, Test-Suite Skill, Content Graph AI 1.0.3
โ New Coding-Time Skill โ PR #6108.
.agents/skills/mcp-ai-wpoos-test-suite/SKILL.mddistills the campaign into an operational repair playbook: Docker test commands (WP 6.9/7.1), CI log-zip triage, 16 recurring root-cause patterns (hook resets, singleton interference, WP_Error envelope drift, nonce/user binding, WP 6.9 queue memoization, anonymous-class visibility), the production-fix-vs-test-fix decision, and cluster-PR branch/commit/validation conventions. Plugin skill updated with current contracts;AGENTS.md+ copilot instructions registered;TEST-SUITE-REMAINING-FIXES-PLAN.mdadded. Coding-time skills: 52 โ 53.โ PHPUnit Suite Repair Campaign โ PRs #6008, #6009, #6012โ#6107, #6109. ~100 cluster PRs brought the suite green. Production fixes carried by the campaign: assistant-access caching (
wp_mcp_ai_assistant_access_cache_enabledfilter + WP_Error caching, #6008); attachment-segment validation errors return explicit 400s (#6009); token-tier endpoint + tier-change audit logging (#6018); REST permission-callback allowlist refresh (#6019); bearer-auth context sync (#6014, #6016); REST analytics endpoints (#6015); job-queue closure serialization in legacy option storage (#6020);TIER_META_KEYchart-data constant (#6021); custom-table query guards against missing schema โ Graphify DB/memory bridge, job store, tenant DB (#6022); restoredWP_MCP_AI_Job_Notifier::update_status(), dot-preserving job IDs, source scoping (#6036); job-notifier REST routes for dot-IDs + owner auth (#6037); Little's-law metrics (#6038); job status promoted to running on progress updates (#6039); web-search result building restored for Exa/Perplexity (#6042); profession CPT meta clamping + primary-role flow (#6043); federation mesh-sync init (#6044); output-buffer leaks across render/AJAX paths (#6045); memory-capture failure envelope restored (#6049) + WPCS violations (#6052); container settings repository service ID (#6050); ecommerce toolkit enablement helper (#6051); A2A webhook logging + delegate tool errors (#6055); Media Toolkit tools normalized toWP_Error(#6057); autonomous-session tool error logging (#6058); Cloudways analytics adapter auth check (#6062); auto-categorize router/client (#6064); Graphic Editor Plus image access on WP 6.9+ (#6069); workflow-editor AJAX WP_Error/hook drift (#6070); Remove Background path guard + source resolution (#6072); quiz + document-template admin pages (#6089, #6090); profession service + aggregate results (#6096); NPM integration notice determinism (#6097); profession team CPT sanitization (#6105); Graphify admin classes load defensively onplugins_loaded(#6106); Shopify Sync CCT manager validates variant IDs before the JetEngine availability check (#6109).โ Content Graph AI 1.0.3 โ PR #6056. Tool permission-check fix + addon bump; ZIP v1.0.3 ships in
build/.โ Checkout API Addon + Content Graph Paid Checkout โ PR #6063. New
addons/checkout-api/v0.1.0 (vendor-side Stripe checkout service:/wp-json/nvoos-checkout/v1/session/verify endpoints, custom-table license store, signed expiring HMAC-SHA256 download URLs capped at 10/link, signature-verified idempotent webhooks with refund/dispute revocation and server-side license issuance onpayment_intent.succeeded, per-IP rate limiting, storefront admin; Stripe secrets encrypted at rest, PHP 8.1+, vendor-server only). The freenvoos-content-graphplugin gains the client half: Stripe Payment Element modal, verify-via-vendor-API, local license key, one-flow install/activate from the signed URL, admin-onlyPOST /payments/session|verifyendpoints, fournvoos_content_graph/payments/*filters, throttled session creation, anddownload_url()+Plugin_Upgraderfilesystem checks โ no Stripe keys ship in the plugin. Contract:plugins/nvoos-content-graph/docs/commerce-vendor-api.md.๐งน Housekeeping. Stale 1.1.65 build ZIPs +
.sha256removed frombuild/(root,optional-components/,toolkit-addons/), matching the 1.1.63/1.1.64 cleanup convention.๐ฆ Versioning โ bumped to 1.1.66 across all version-bearing files. Pro addon: 1.1.66. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged; paid-checkout client merged, version bump pending). nvoos-content-graph-ai: 1.0.3 (bumped this window). Checkout API addon: v0.1.0 (new). Tool count: ~303 base + ~1,256 Pro (~1,559 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 27. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 53.
๐ Latest Updates (v1.1.65 โ August 2026)
August 26โ28, 2026 โ Reasoning-Model Fixes, Full-Crawl4AI Proxy, Security-Posture Closure, Chat/REST Hardening
โ OpenAI Reasoning-Model Parameter Rejection โ PR #5985.
OpenAiCompatibleClientstripsmax_tokens/temperaturefrom o-series/gpt-5 payloads (applyModelConstraints()) and retries 400 rejections with corrected payloads (sendWithParameterCorrection()) on both sync and streaming paths. Content Graph AI:EmbeddingServiceresolves the embedding provider deliberately (OpenAI preferred when keyed โ most chat providers lack/embeddings) and honors the configuredembeddings_model;\Throwableguards returnWP_Errorinstead of fataling; the chat API reportsgraph_context_modeand falls back to keyword search over node labels without an index; the reindex button is always restored on server errors.โ Media Worker Full-Crawl4AI Proxy (031 Phase 3) โ PR #5983. Env-gated
POST /api/crawl/full+GET /api/crawl/full/task/:idinsrc/routes/crawl.js: every target URL is SSRF-validated before the payload is proxied toCRAWL4AI_FULL_URL, token-gated like every/apiroute, with503 service_not_configured/502 upstream_unreachable/400envelopes.TEMP_ROOTbecomes the allowlisted sandbox root underSTRICT_PATHS=1(028 Q5, default flip deferred to worker 4.0.0). Worker stays v3.2.0. Proposals 028/031 updated.โ Security-Posture Findings Closed โ PR #5981 (issue #5972). F-AI-01: Algorave Tone.js raw eval requires a per-session confirmation + warning banner (capability-scoped via
nvoosAlgoraveConfig; Strudel unaffected). F-CMP-04: TMA markdown source map removed. F-AUTHZ-01: webhook__return_truecallbacks carry justification comments.SECURITY_POSTURE.mdupdated in-commit.โ Chat, REST & Transcript Hardening โ PRs #5991, #5993, #5994. Chat route no longer declares a top-level
attachmentsarg (embedded segments authoritative; legacy clients tolerated); role enum validation moved to the sanitize layer (custom-role filter works again); attachment segment prep errors propagate to the client; orphaned tool messages silently discarded before dispatch; sign-preserving pagination sanitizer + guest-token helper; guardrail pre-screening skips array content.โ Webhook, Shortcode & Pro-Tool Fixes โ PR #5990. Google Chat
verification_tokenshared-secret auth when OIDC is disabled (?token=/X-Google-Chat-Token); Slack conversion anchor placeholders + italic-before-bold ordering; paper-store import/export missing-collectionguards; idempotent scheduled-result block registration.โ Slash Commands & Blocks โ PRs #6000, #5997. Toolkit manager re-resolves the handler at registration (
initre-fire sync); CSV lists accept"1,2"and"1, 2"; assistant-builder/Pro toolkit blocks skip already-registered names (WP 7.1 notices).โ AJAX, TPM & Admin Settings โ PRs #6004, #6005, #6006. Workflow-execution
wp_send_json_*moved out of the try block; model-manageroverwriteaccepts1/true/yes/on;research_modelprovider-error ordering; TPM falls back to the bundled model catalog (longest-prefix) when the CCT has no entry; dangling legacy high-token/security-monitor sections removed; WP 7.0 bridge checksWP_Connector_Registry::is_registered()first.โ Graphify & Remote-Connection Guidance โ PRs #5986, #6003. Provider-prefixed
*_keyfields treated as sensitive;sync_remote_sourcereturns canonicalWP_Error;remote_wp_connectionerrors direct callers tolist_connectionsfirst.โ Content Graph wp.org Refresh โ PRs #5980, #5988, #5982, #5992. Icons (v5), main screenshot, generated page preview; Contributors field fixed; Content Graph AI chat tester fixed (settings store, graph adapter, SSE, core bridge).
โ Test-Suite Cluster Fixes โ PRs #5995โ#5999, #6001, #6002. SSE stream-contract alignment, WP 7.1 icon-init replay neutralisation, transcript CI follow-ups, Phase 4 slash-command suites, SSE tool-result extraction, transcript roundtrip skip without CCT. Docs-only: doc open items โ GitHub issues (PR #5979), Ralph Wiggum proposal recorded as implemented (PR #5984).
๐ฆ Versioning โ bumped to 1.1.65 across all version-bearing files. Pro addon: 1.1.65. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged). Tool count: ~303 base + ~1,256 Pro (~1,559 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 52.
๐ Latest Updates (v1.1.64 โ August 2026)
August 24โ26, 2026 โ Google Calendar Connection, Composio Account Health, Log Hygiene, Non-Loggable Fields
โ Google Calendar Connection & Shared Google Services โ PR #5959 (32 files, +9,373/-206 lines). New
includes/google/foundation (OAuth service, Calendar v3 client, scope registry, credential resolver, sync + push) replaces four drifted Google OAuth copies;google_calendarconnection type on both connection surfaces; six new Pro google-workspace tools (list_google_calendars,list_google_calendar_events,update_google_calendar_event,delete_google_calendar_event,check_google_calendar_availability,quick_add_google_calendar_event) plus a reworkedcreate_google_calendar_eventand a realsync_google_calendar. Scope enforcement on every write; push channels + Action Scheduler sync. Reference:docs/developer/architecture/integrations/google-calendar-connection.md,docs/reference/google-calendar-api-v3.md.โ Composio Verified Account Health & Real Tool Discovery โ PR #5936 (23 files, +5,602/-258 lines).
WP_MCP_AI_Composio_Account_Healthledger + live probe (catalog-discovered zero-argument read-only tools, curated fast path, honeststatus_onlydegradation), new seventh toolcomposio_manage_accounts(validate/reconnect/delete/prune, in-place reconnect), in-band failure conversion, v3.1 envelope unwrapping + corrected query params, ID-swap diagnosis by prefix, Health column with Verify/Reconnect in Remote Sites. Seedocs/composio-connect.md.โ Composio Proxied Provider Failures & Stale Account IDs โ PR #5953 (11 files, +516/-35 lines). Proxied provider refusals inside
dataare now authoritative failures (401/403 โ auth-required + reconnect machinery), bounded execution-error path walk, anchored status scan (content false-positives structurally excluded), staleconnected_account_idfast-fails.โ Composio Zero-Argument Payload & Probe Determinism โ PR #5958 (6 files, +677/-28 lines). Empty
argumentsencode as{}(never[]), validationdetailflattened, boundedupstreambody onWP_Error, cache-index invalidation for filtered listings, deterministic probe ranking + curated Google Calendar probe.โ Composio Auth Config, Listings & App Removal โ PRs #5932โ#5934 (26 files, +1,715/-80 lines). Link-endpoint auth config resolution (
auth_config_id/user_id/callback_url), real 401/403 error surfaces, API-key trim/validate; v3.1 listing envelope unwrap + Connected Apps list on the edit form; identity-bound execution (from_connection()), nonce-gated Remove that revokes the upstream grant.โ Tool-Declared Non-Loggable Result Fields โ PR #5961 (16 files, +796/-15 lines).
WP_MCP_AI_Tool_Sensitive_Result_Interfacewith dot-notation/*/subtree field declarations; the logger masks before preview truncation on the success, argument, and error paths; legacy-wrapper forwarding; additive-only filter; 8 declarers.โ Log Context Bloat & Rolling-Buffer Compaction โ PR #5952 (21 files, +2,599/-22 lines). Per-entry byte budget on the persistence path (fingerprinted
assistant_config/system_prompt, truncation, 12 diagnostic keys preserved), Extended budget 16โ8 KB,previous_resultsno longer embedded (O(Nยฒ) fix), Data Management Compact/Delete viawp_mcp_ai_maintain_log_buffers.โ Secret URL Query Params in Logged Strings โ PR #5954 (3 files, +1,238 lines). 26 credential-bearing parameter names masked in the shared redactor (scheme/host/path/non-secret params preserved) โ covers tool arguments, error messages, and
error_log(); ships the Google Calendar implementation plan doc.โ MCP JSON-RPC Error Paths & Diagnostics Re-wiring โ PR #5957 (10 files, +372/-134 lines).
/mcpjsonrpc/methodno longerrequiredso-32700/-32600envelopes are reachable; MCP Server Diagnostics page, assets, and AJAX handlers re-wired after the entry-file rename.โ Validated-Tool Validation Restored on Symfony 5.4 โ PR #5960 (14 files, +143/-107 lines). The
enableAttributeMappingguard never fired on ^5.4 so constraint loading was silently skipped; version-appropriate helper +WPCapabilityconstructor fix.โ Pro SPA v2 Conversation & Assistant Sync โ PR #5962 (5 files, +537/-48 lines).
selectSessioncarriesassistant_id, stored sessions hydrate on mount, assistant switches start fresh conversations.โ Vision Tools Timeout Parameter โ PR #5964 (20 files, +446/-113 lines). 5โ300s
timeoutargument + globalrequest_timeoutinheritance viaWP_MCP_AI_Vision_Request_Timeout; OCR client download/health paths covered.โ WP_Error Envelope Drift & Tool Bugs โ PR #5965 (18 files, +203/-112 lines). Canonical-envelope test conformance,
plan_schedules_from_workflowregex fix, double-prepare()fix, trackedjob_idreturns, cron pruning,modeltype constraint.โ Test-Env Registration & Suite Follow-Ups โ PRs #5931, #5935 (66 files, +1,416/-564 lines). AJAX suite class loading, dispatch hardening, WP All Import bootstrap guard, moved-file requires.
โ Content Graph wp.org Assets โ PR #5963 (7 files). Banner/icon/screenshot assets for the
nvoos-content-graphlisting.๐ฆ Versioning โ bumped to 1.1.64 across all version-bearing files. Pro addon: 1.1.64. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged). Tool count: ~303 base + ~1,256 Pro (~1,559 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 52.
๐ Latest Updates (v1.1.63 โ August 2026)
August 22โ23, 2026 โ Artifact Evolution Phases AโG, Pro Addons Page, Storage Worker Offload, Test-Suite Exit Traps
โ Artifact Evolution Phases AโG โ PRs #5923, #5925 (52 files, +11,666/-75 lines). The Continual Harness Evolver + Meta-Harness become a complete gated Darwinian self-improvement loop for skills, prompts, and roles (proposal 007). Phase A repairs the broken
evolve_harnessโ Evolver contract (analyze_failures(), component-scopedevolve()with enforceddry_run, constructor normalization) and adds opt-in evolved-prompt consumption (WP_MCP_AI_Evolved_Prompt_Resolver) + evolved-skill merge into the Skill Registry, Refiner output sanitization/PII scrubbing, and a $5/hr default budget. Phases BโG add artifact-scoped eval suites with failure-case replay and post-mutation verification, artifact populations with parent sampling, learning-log-aware mutators, a pre-commit admission gate (three critics โ contamination control), holdout-gated deployment with shadow A/B and drift rollback, and a governor with human approval queue + lineage graphs + an artifact-governance metabox on the assistant screen. New Settings โ Orchestration Layer switches bridge the evolution filters. Every layer is opt-in and defaults off. 16 new/expanded test suites. Reference:docs/project/proposals/007-artifact-evolution.md+ implementation plan; self-evolution governance section indocs/operations/compliance/EU_AI_ACT_2026.md.โ Pro Addons Admin Page โ PR #5924 (7 files, +1,086/-1 lines). New registry-driven NV oOS Pro Dashboard โ Addons page (
/wp-admin/admin.php?page=wp-mcp-ai-addons,WP_MCP_AI_Addons_Page, 813 lines) installs and activates standalone addons whose ZIPs ship inbuild/โ nonce +install_plugins+ allowlist gated; non-WordPress components listed read-only. AJAX test matrix included.โ Chat Storage Worker Offload (proposal 032 v2) โ PR #5928 (30 files, +1,198/-210 lines). Conversation saves โฅ
wp_mcp_ai_storage_worker_threshold(default 10,000 chars) offloadJSON.stringifyto the browserstorage-worker.jsviawpMcpAiStorageUtil; small saves, unload flushes, and worker failures fall back to the synchronous main-thread write with quota-retry. Per-call threshold overrides,storageWorkerUrl/storageWorkerThresholdlocalized on every chat surface, and a filter kill switch (0 = off). LLM worker manager URL resolution fixed (localized workerUrl โ pluginUrl fallback โ explicit error). Reference:docs/project/proposals/032-chat-web-workers-wiring-implementation-plan.md.โ DeepSeek Empty-Schema Fix โ PR #5926 (6 files, +253/-17 lines). Schema normalization produced
"properties": []which DeepSeek rejects ("[] is not of type 'object'"); empty maps now encode as{}at all three payload boundaries (REST, Tool Service, ChatOrchestrator), and legacy tools are wrapped before the first register attempt so the fail-loud registry log no longer fires for successfully wrapped classes.โ OKF Skill-Knowledge Conformance โ PR #5919 (91 SKILL.md files + 4 reference files).
type: Skillfrontmatter added to every bundled SKILL.md lacking it; reference files restored for wp-plugin-dto, wp-plugin-presenter, wp-action-scheduler, and mcp-builder;.agents/skillssync now recursive + covers all project-owned design skills. The OKF Validate tab no longer reports missing concepts.โ Test-Suite Exit Traps โ PR #5929 (40 files, +2,121/-472 lines). New
bin/sweep-tests.php(parallel 6-worker sweep, 180s/file cap, report + custom report path), AJAX test contracts intests/bootstrap.php, and 24+ test files aligned. Production fixes kept minimal: bare-exit guards in four admin handlers (WP_MCP_AI_TESTS_RUNNINGseams), duplicate CRM workflow-rule class renamed, toolkit MCP scope check now passes null (non-OAuth) scope and resource URIs skipesc_url_raw()(nvoos://scheme preserved), SSE/Veo polling-limit filters added, export-providerlog_action()public. Reference:docs/developer/testing-docs/TEST-SUITE-REMAINING-FIXES-PLAN.md.โ Pro SPA v2 Slash-Command Composer โ PR #5920 (8 files, +520/-109 lines).
/chat,/new,/clear,/copy,/exportinsert reliably from the SlashCommandsDrawer (also openable from the AgentPanel button); baseassets/js/slash-commands.jsfixes. Fix history:docs/history/2026/fixes/pro-spa-v2-slash-command-composer-fix.md.๐ฆ Versioning โ bumped to 1.1.63 across all version-bearing files. Pro addon: 1.1.63. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged). Tool count: ~303 base + ~1,249 Pro (~1,552 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 52.
๐ Latest Updates (v1.1.62 โ August 2026)
August 21โ22, 2026 โ OKF Bundle Management, Pro Skills Drawer, Vector Store Responses API Migration
โ OKF Bundle Management & Pro Knowledge Routing โ PR #5914 (47 files, +8,453/-284 lines). Ships the full OKF enhancement roadmap (Phases AโH):
WP_MCP_AI_OKF_Bundle_Managerbundle lifecycle (create, rename, archive, delete, ZipSlip-safe ZIP import/export, health stats) withskill-knowledgeprotected; three new base tools (okf_list_bundles,okf_validate_bundle,okf_import_bundle) plus theokf_write_conceptprovenance schema โ OKF tool surface now 10 tools; a new Bundle Manager admin screen (Bundles/Browser/Editor/Import-Export/Validate, nonce + capability-gated AJAX); Pro OKF-to-Skill Bridge (load_skillresolvesbundle:concept_idwith per-assistant grants + trust gating), auto-enrichment agent (okf_enrich_site_content), and hybrid knowledge router (route_knowledge_query). 10 new OKF test suites (116 tests) + 3 manual smoke scripts. Reference:docs/features/okf-integration.md,docs/project/plans/OKF-BUNDLE-MANAGEMENT-IMPLEMENTATION-PLAN.md.โ OKF Skills Drawer in Pro SPA v2 โ PR #5915 (15 files, +3,148/-65 lines). New read-only
mcp-ai-pro/v1/okfREST surface (bundle list/stats, concept browse + search, assistant skill grants) wired through the Pro module registry + SPA loader; newOkfDrawercomponent (1,020 lines) lets users browse OKF bundles/concepts and reference them from chat. Also declaresWP_MCP_AI::$admin_okf_bundle_manager(PHP 8.2 dynamic-property fix).โ Percent-encoded OKF Concept Route Fix โ PR #5916 (2 files, +52/-3 lines). Concept IDs containing
/arrive as%2Fand 404'd; the route pattern now allows%and the handlerrawurldecode()s before the reader lookup.โ Vector Store Tools โ Responses API โ PR #5917 (10 files, +1,222/-73 lines). OpenAI removes the Assistants API on 2026-08-26: every vector-store call site drops the
OpenAI-Beta: assistants=v2header, file ingestion moves tofile_batcheswith bounded polling (wp_mcp_ai_vector_store_batch_poll_max_seconds) and a headerless single-file fallback, and the clients gainfilter/ranking_optionssupport. New migration test suite (12 tests).๐ฆ Versioning โ bumped to 1.1.62 across all version-bearing files. Pro addon: 1.1.62. Media Worker: v3.2.0 (unchanged). Tool count: ~303 base + ~1,249 Pro (~1,552 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 52.
๐ Latest Updates (v1.1.61 โ August 2026)
August 21, 2026 โ Agent Identity Bridging, OKF Bundle Generator, undici Pin
โ Agent Identity Bridging in Memory Store & Recall (29 files, +1,416/-165 lines). New
WP_MCP_AI_Agent_Identity_Resolver(includes/services/class-wp-mcp-ai-agent-identity-resolver.php) canonicalises virtual agent keys (SPA drawer aliases,virtual_planner_*) to the canonical assistant post ID; the alias map (wp_mcp_ai_agent_id_aliases) is bounded (200), never autoloaded, and sanitised.store_agent_contextresolves on store and echoesoriginal_agent_id/agent_id_resolved; REST chat-memory recall merges alias buckets (stored_underper record,merged_sources, default limit 25); wing/room-scoped recall keeps single-bucket semantics. Drawers (base, chat-spa, pro-spa) show wing/room/stored-under chips, an agent-ID diagnostic, a show-all-scopes toggle, and store-triggered refresh;wake_up_contextgraph failures fall back to the transient path and scoped wake-up/recall errors retry unscoped. New tests:tests/test-agent-identity-resolver.php, memory-drawer JS/SPA additions. Reference:docs/features/memory/chat-client-integration.md.โ OKF Skill-Knowledge Bundle Generator โ PR #5911 (6 files, +817/-1 lines).
WP_MCP_AI_OKF_Skill_Knowledge_Generatorgenerates theskill-knowledgebundle fromincludes/bundled-skills/on bootstrap (priority 32) when missing or when the plugin version changed, and regenerates after admin bundled-skill reinstall โ everyokf_*tool now works out of the box instead of failing with "OKF bundle not found: skill-knowledge". Reference:docs/features/okf-integration.md.โ undici ^7.29.0 jsdom Compatibility โ PR #5910 (14 files). jsdom 29.1.1 deep-requires
lib/handler/wrap-handler.js(removed in undici 8), breaking vitest in seven addons; the override is pinned to ^7.29.0 โ newest 7.x, all CVE fixes retained.โ nvoos-content-graph wp.org Review Reply & Report โ PR #5912 (5 files, +260/-3 lines).
WPORG-REVIEW-REPLY.md+WPORG-REVIEW-DETAILED-REPORT.md;WPORG-REVIEW-*.mdexcluded from distribution ZIPs.โ Content Graph CI ZIP Checksum Sync โ PR #5906 (2 files). Build jobs upload and commit the matching
${ARTIFACT}.zip.sha256(previously${ARTIFACT}.sha256), ending checksum drift for CI-rebuilt ZIPs.๐ฆ Versioning โ bumped to 1.1.61 across all version-bearing files. Pro addon: 1.1.61. Media Worker: v3.2.0 (unchanged). Tool count: ~300 base + ~1,247 Pro (~1,547 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 52.
๐ Latest Updates (v1.1.60 โ August 2026)
August 20โ21, 2026 โ Restricted-User Flagging, Conversation Import, Tool Schema Normalization
โ Restricted-User Flagging & Unblocking โ PR #5901 (26 files, +3,568/-20 lines). New
WP_MCP_AI_Restriction_Registry(includes/class-wp-mcp-ai-restriction-registry.php) converts ephemeral rate-limit and token-budget blocks into persistent, enumerable restriction records (user meta +wp_mcp_ai_active_restrictionsindex, daily cleanup cron, audit-logged). The OOS rate-limiter adapter fireswp_mcp_ai_rate_limit_exceeded; chat rate limits are filterable (wp_mcp_ai_chat_rate_limit/wp_mcp_ai_chat_rate_limit_window). Admin surfaces: Token Manager "Restricted Users" panel (Base) + Pro Command Center Restrictions tab; RESTGET /mcp-ai/v1/restrictions,GET|POST /mcp-ai/v1/users/{id}/restrictions,DELETE /mcp-ai/v1/users/{id}/restrictions/{type}; AJAX lift actions;wp mcp-ai restrictions list|lift|add; IETF rate-limit headers; newrestriction_registry_onposture signal. Full reference:docs/features/security/user-restrictions.md.โ Conversation Import to Transcript CCT โ PR #5898 (38 files, +8,791/-4 lines). New
includes/conversation-import/subsystem imports ChatGPTconversations.json(incl. ZIP), Google Takeout Gemini activity, Claudeconversations.jsonl, ShareGPT, and OpenAI fine-tuning JSONL into the JetEngineai_chat_transcriptsCCT โ one row per conversation โ with format detection, tree/branch linearization, idempotent dedupe, dry-run, batching, and checkpoint resume. Four new tools (conversation_import_detect|run|status|delete), an admin upload/preview page with progress reporting,wp mcp-ai conversation-import detect|import|status|delete, GDPR exporter/eraser + retention coverage, media sideloading, and opt-in memory mining viamine_agent_memory. Five PHPUnit suites. Guide:docs/user-guides/conversation-import.md.โ Tool Schema Normalization โ PR #5903 (5 files, +162/-14 lines). Tool argument schemas are normalized before being embedded in provider payloads โ
WP_MCP_AI_DeepSeek_Client, REST/toolsschema output,WP_MCP_AI_Tool_Service, and the OOSChatOrchestratorโ preventing provider streaming failures from non-compliant schemas; the registry now logs tool registrations skipped for a missing tool contract.โ WP_Error Fatal Fixes โ PR #5905 (8 files, +216/-50 lines). Memory tools (
mine_agent_memory,retrieve_agent_memory,wake_up_context), the request guard, and the REST chat-memory controller now handleWP_Errorreturns before array/object access.โ nvoos-content-graph v1.0.3 wp.org Resubmission โ PRs #5897, #5899, #5904. WPCS fixes for the renamed plugins, wp.org review fixes, readme/README polish,
.wordpress-orgscreenshot assets, and the standalone build ZIP.๐ฆ Versioning โ bumped to 1.1.60 across all version-bearing files. Pro addon: 1.1.60. Media Worker: v3.2.0 (unchanged). Tool count: ~300 base + ~1,247 Pro (~1,547 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 52.
๐ Latest Updates (v1.1.59 โ August 2026)
August 19, 2026 โ Media Worker Crawling & Crawl4AI Facade, Research Tools Hardening, Docs Hub + Tool Registration Fixes
โ Media Worker Crawling & Crawl4AI Facade โ PR #5892 (25 files, +3,556/-16 lines). New
/api/crawl/*endpoints in the worker โ single-URL Markdown, batched crawling (sync or queued async), and link scans โ using a two-tier extraction pipeline: static HTTP fetch โ Readability โ Turndown first (zero browser cost), with the hardened Chromium launcher as an automatic fallback for JS-heavy pages. Every URL passes the shared SSRF guard before fetch or navigation. A Crawl4AI-compatible facade (/api/crawl4ai/*) lets the plugin'srun_crawl4ai_jobremote mode target the worker as a drop-in Crawl4AI replacement, plus an LLM-based extraction utility (src/utils/llm-extract.js) for structured page data. Worker bumped to v3.2.0. Toolkit memory estimate now accounts for the worker sidecar (docs/features/TOOLKIT_MEMORY_TRACKING.md). Plan:031-media-worker-crawl4ai-integration-plan.md.โ Research Tools Multi-Provider Hardening โ PR #5893 (22 files, +2,728/-155 lines).
semantic_content_searchnow resolves embeddings through the shared embedding-provider abstraction (OpenAI, Gemini, Ollama, DigitalOcean) independent of the assistant's chat provider, falls back to keyword search when unconfigured (fallback_mode: "keyword"), and skips stored vectors from mismatched models. New Gemini embedding provider (includes/services/embedding/class-wp-mcp-ai-embedding-provider-gemini.php).deep_researchvalidates non-empty completions, falls back toreasoning_contentfor reasoning-only models, retriesfinish_reason: lengthwith a doubled budget, walks the provider chain, and never caches empty reports. Two new read-only base tools:list_terms+list_taxonomies. New test suites:test-tool-deep-research.php,test-tool-semantic-content-search.php,test-tool-list-terms.php,test-tool-list-taxonomies.php,test-mempalace-phase3-embedding-providers.php.โ Docs Hub Rebuild & Broken-Link Suggestions โ PR #5894 (9 files, +708/-54 lines). The copy-in-place updater bypasses
Plugin_Upgrader, soupgrader_process_completenever fired and Docs Hub caches went stale after updates. The updater now fireswp_mcp_ai_plugin_updatedafter every successful in-place update; Docs Hub 0.4.1 reacts with a cache clear + async rebuild (cached remote content preserved) plus anadmin_initversion-mismatch guard for manual replacements/restores. Broken-link detection now resolves relative links against the slug map (fixing the "626 broken links" false positive on remote-only indexes); suggestions are case-insensitive with confidence clamped to [0.3, 1.0]. New tests:test-rebuild-job.php,test-indexer.php.โ Tool Registration & QA Infrastructure โ PR #5895 (44 files, +1,151/-207 lines). Legacy-format tool classes (pre-interface) are transparently wrapped (
WP_MCP_AI_Legacy_Tool_Wrapper+WP_MCP_AI_Tool_Legacy_Definitiontrait); ~32 previously-orphaned base tool files are now registered; a newwp_mcp_ai_tools_initaction gives side-loaders (e.g.includes/orchestration-init.php) a late registration point; the registry tracks skipped tools inunavailable_tool_slugs. QA container memory limits raised (tests/qa/docker/docker-compose.qa.yml) andbin/install-test-plugins.shhardened.๐ฆ Versioning โ bumped to 1.1.59 across all version-bearing files. Pro addon: 1.1.59. Media Worker: v3.2.0. Tool count: ~300 base + ~1,243 Pro (~1,543 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 52.
๐ Latest Updates (v1.1.58 โ August 2026)
August 18, 2026 โ Composio Connect, OOS Runtime Consolidation, Content Graph Rename
โ Composio Connect Integration โ PR #5889 (29 files, +5,318/-2 lines). New
addons/pro/includes/composio/subsystem bridges WordPress to the Composio MCP gateway: OAuth connection flow with state nonce (WP_MCP_AI_Composio_Auth_Handler), API client (WP_MCP_AI_Composio_Client), trigger bridge (WP_MCP_AI_Composio_Trigger_Bridge), and signed webhook controller (WP_MCP_AI_Composio_Webhook_Controller). Six new beta tools โcomposio_list_tools,composio_get_tool_schema,composio_list_connected_accounts,composio_create_connect_link,composio_execute_tool,composio_manage_triggersโ plus remote-sites admin and metabox panels (connected-apps badge). 4 test classes (+887 lines). Full details:docs/composio-connect.md,docs/toolkits/composio-connect.md.โ OOS Runtime Consolidation Phases 0โ5.8 โ PR #5881 (8 commits). The OOS engine reaches parity with the legacy path: Phase 0โ2 parity foundations (
includes/bootstrap/oos-bridge.php, tool-surface + security-gate contracts), Phase 3 event-sourced session log (SessionLog/SessionEvent/SessionTelemetry+ observer), Phase 4 shadow mode (includes/oos/parallel parity runs serving the legacy result;wp mcp-ai oos parityCLI) + canary routing (per-assistant_wp_mcp_ai_engineopt-in), Phase 5 scoped tools (ToolScope) + compaction seam (CompactionProvider) + Pro composition & child binding (addons/pro/includes/composition/), and Phase 5.8 telemetry single-path. Full details:docs/project/proposals/029-oos-orchestration-runtime-consolidation-implementation-plan.md.โ Graphify Standalone Plugins โ Content Graph โ PR #5890.
plugins/nvoos-graphifyโnvoos-content-graph(v1.0.2),nvoos-graphify-aiโnvoos-content-graph-ai(v1.0.2),nvoos-graphify-ai-platformโnvoos-content-graph-ai-platform(v1.0.2), with matching build/sync workflow renames andbin/build-*-content-graph*.shscripts. Theaddons/graphify/knowledge-graph addon is unchanged.โ Security Center wp.apiRequest Fix โ PR #5887 (1 file, +8 lines). The security tab's inline scripts (posture refresh, IP tests, snapshot restore, compliance export, self-test) call
wp.apiRequest()butwp-apiwas never enqueued there. Now enqueued when?tab=securityis active. Seedocs/history/2026/fixes/security-center-wp-api-request-fix.md.โ deepmerge-ts CVE-2026-40345 โ PR #5888 (4 files, +30/-6 lines). Override pinned in
addons/media-worker/package.jsonandaddons/pro/package.json.๐ฆ Versioning โ bumped to 1.1.58 across all version-bearing files. Pro addon: 1.1.58. Media Worker: v3.0.0 (unchanged). Tool count: ~265 base + ~1,243 Pro (~1,508 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 51.
๐ Latest Updates (v1.1.57 โ August 2026)
August 15, 2026 โ Updater Rework, Hermes Async Chat, Provider Detection Fix
โ Plugin Updater: Base-Only Updates & In-Place Install โ PR #5871 (5 files, +530/-266 lines). New base-only update flow for wp.org installs:
check_for_base_update()plus thewp_mcp_ai_check_base_update/wp_mcp_ai_start_base_updateAJAX handlers power a new "Base Version" panel in Settings โ Advanced, resolving the GitHub base package (ASSET_BASEpattern, incl. legacymcp-ai-wpoos-base-*naming) so base installs can update without upgrading to complete. Installation reworked fromPlugin_Upgraderto copy-in-place (replace_plugin_from_zip()): the live plugin directory is never renamed, a backup snapshot is restored on failure, and base โ complete upgrades deactivate a separately installed Pro addon to avoid double-loading. Pro version now read from the plugin header (get_pro_installed_version(), constant fallback), fixing drift in the imaging admin page and Pro CLI status. Full details:docs/features/plugin-updater.md,docs/history/2026/fixes/base-update-path-fix.md.โ Hermes WebUI Chat โ Async Submit/Poll โ PR #5872 (2 files, +15/-7 lines).
hermes_chatsubmits via/api/chat/startand polls/api/chat/stream/statusinstead of a blocking request: runs keep executing server-side if the MCP client drops mid-run,HERMES_CHAT_TIMEOUTexpiry returnsstatus: "still_running"with thestream_id, and approval gates are answered with the configuredHERMES_APPROVAL_MODEchoice (askleaves it pending). Answer extraction fixed for live WebUI payload shapes.bin/README.mdupdated.โ Fleet Operator Agent Context โ PR #5873 (18 files, +574 lines). New
addons/fleet-operator/.context/tree: addon conventions, Hermes ops, MCP integration, design content, wp-plugin-dev rules, 6 operator roles (analyst/architect/developer/product-manager/qa/scrum-master), active/archive scratch areas, and task/memory templates.โ Service Status AI-Provider Detection โ PR #5874 (2 files, +168/-20 lines). Provider detection now resolves credentials through
WP_MCP_AI_Credential_Resolver(plugin settings, WP 7.0 Connectors, environment variables, PHP constants) with a merged-settings fallback for early bootstrap; Ollama remains keyless. New test suitetests/test-service-status-provider-detection.php. Seedocs/history/2026/fixes/service-status-provider-detection-fix.md.๐ฆ Versioning โ bumped to 1.1.57 across all version-bearing files. Pro addon: 1.1.57. Media Worker: v3.0.0 (unchanged). Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 51.
๐ Latest Updates (v1.1.56 โ August 2026)
August 14, 2026 โ Media Worker Multi-Tenancy & Scale (v2.4.0 โ v3.0.0), Worker Routing, Hermes Tooling
โ Media Worker Multi-Tenant Shared Worker Mode โ PR #5866 (21 files, +1,349/-304 lines).
SITE_TOKENSJSON map switches the worker into per-site isolation: every/api/*request must carry a token belonging to a known site (fail-closed withAUTH_MODE=strict), and temp files, job queues, and rate limits are namespaced per site slug via the newsrc/utils/site-paths.js. Per-site rate-limit overrides (RATE_LIMIT_*_<SITE>),SITE_TOKENS_PREVIOUSrotation overlap, audit logs taggedsite=<slug>. Specs:026-media-worker-multi-tenancy-sidecar-proposal.mdand027-media-worker-multi-tenancy-phase2-spec.md. (PR #5866)โ Media Worker Phase 2 โ Per-Site Provider Keys & Observability โ PR #5868 (8 files, +366/-50 lines).
SITE_PROVIDER_KEYSJSON map resolves per-tenant AI provider credentials before falling back to the shared pool (PROVIDER_KEYS_STRICT=1disables the fallback);tenants.usageper-site provider usage counters; grouped temp TTLs (TEMP_TTL_UPLOAD/VIDEO/BROWSER/DOC) with storage stats; cluster-mode boot warnings and a k6 load-test kit underaddons/media-worker/bin/load-test/. (PR #5868)โ Media Worker Phase 3 โ Scale Without Breaking Changes (14 files, +602/-63 lines). Worker bumped to v3.0.0. W1: per-blog worker tokens on WordPress multisite (additive option chain in the sidecar trait). W2: new
WP_MCP_AI_Media_Worker_Usage_Reporter(includes/class-wp-mcp-ai-media-worker-usage-reporter.php) โ daily cron snapshotstenants.usageinto an option and fireswp_mcp_ai_media_worker_usage_updated(opt-in, off by default). W3:SITE_TOKEN_<SLUG>/SITE_PROVIDER_KEYS_<SLUG>env-var merges over the JSON maps (env wins). W4: opt-in Redis rate-limit store (RATE_LIMIT_REDIS=1+rate-limit-redisoptional dep) for PM2 cluster mode. W5:PROVIDER_KEYS_FILEhot-reload with atomic replace and malformed-update rejection. W6 revised: permissive-mode boot notice only โ the strict-path default flip is deferred (open Q5). W7: manual Velocity deploy workflow. 59 unit tests passing. Plan:028-media-worker-phase3-proposal.md.โ Worker Routing Expansion (4 PRs, +2,370/-408 lines). Document generation (Word/Excel/PDF merge/watermark), OCR, video frame extraction, health charts, email (Nodemailer/MJML), QR/translate/PDF-extract, image vectorization, Prettier, and FFmpeg now route through the connected worker with local fallbacks unchanged; Pro settings page lists worker-routed packages. New
addons/media-worker/bin/probe-wordpress.phpprobes the WordPress side (connectivity, tokens, package availability).โ Zero-Downtime Token Rotation & Canvas v3 โ PRs #5864, #5865.
WORKER_API_TOKEN_PREVIOUSaccepted during the rotation overlap window; Canvas upgraded to v3 napi prebuilds for compiler-free installs on managed hosts. Cloudways readiness hardening (endpoint test script, queue/route resilience) โ PR #5863. Live data/PDF route bug fixes โ PR #5867.โ Hermes WebUI MCP Server, SSH Bridge & Skill Sync โ PR #5862 + 3 follow-ups (8 files, +788/-13 lines).
bin/hermes-mcp-server.jsdrives a Hermes agent from Zed as a stdio MCP server: serialized WebUI logins, session cookie + synchronous chat, toolshermes_list_sessions/hermes_chat/hermes_session_detail/hermes_sync_skills.bin/mcp-bridge-ssh.js+bin/utils/fake-ssh.jsadd the SSH bridge;bin/hermes-skill-sync.js/bin/sync-skills-to-hermes.jsmirror the repo.agents/skills/tree into the agent (idempotent upsert + prune); env-file parser hardened. Zed Hermes Console profile added to.zed/settings.json.๐ฆ Versioning โ bumped to 1.1.56 across all version-bearing files. Pro addon: 1.1.56. Media Worker: v3.0.0. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 51.
๐ Latest Updates (v1.1.55 โ August 2026)
August 13, 2026 โ MCP Agent Compatibility, Fleet Operator, Media Worker Hardening, Connection Pooling
โ MCP Agent Compatibility & Tool Reliability โ PR #5859 (8 files, +1,435/-32 lines). JSON-RPC errors now return HTTP 200 with the error envelope so client SDKs that drop non-2xx bodies relay tool errors instead of leaving agents hanging (auth/permission failures and pre-dispatch guards keep real HTTP statuses; filter
wp_mcp_ai_mcp_error_http_status). Legacy MCP HTTP+SSE transport added for SSE-only clients (Accept: text/event-streamor?stream=true) with a credential-bound session handshake fromGET /mcpand responses delivered asevent: messageon the GET stream โ backed by the newWP_MCP_AI_SSE_Session_Store(327 lines), gated byWP_MCP_AI_LEGACY_SSE_ENABLED. Tool rate limiter is now settings-driven (tool_rate_limit_max/tool_rate_limit_window/tool_rate_limit_exempt_tokens) with a security admin section; credential-token traffic exempt by default. GET/HEAD exempt from the request quota so discovery/SSE probe retry loops don't exhaust the hourly budget. Rawcred_*authorization headers (noBearerprefix) accepted for agent configs that forward headers verbatim (filterwp_mcp_ai_accept_raw_credential_header). Async tool polling bounded at ~45s (15 polls ร 3s) with inline kick of stuck jobs to stay under Cloudflare 524 timeouts. (PR #5859)โ Hermes Fleet Operator Addon โ PR #5858 (18 files, +2,587/-8 lines). New
addons/fleet-operator/addon issuing scopedop_operator credentials with audience binding, expiry, rate limits, and instant revocation so a supervisor agent (Hermes or any MCP/A2A host) can operate the site within an allowlist. Server-side MCPtools/listscoping plustools/callenforcement and audit attribution via base-plugin hooks;/mcpmethod enum relaxed so ping and notifications from standard clients reach the JSON-RPC handler. Ships admin page, WP-CLI commands, Hermes config generator, 3-skill nvoos pack (nvoos-approvals,nvoos-operations,nvoos-site-context), runbook (docs/operations/fleet/hermes-operator-setup.md), and PHPUnit coverage (406 lines). (PR #5858)โ Media Worker v2.2.0 Security Hardening โ PR #5857 (22 files, +1,247/-215 lines). Nine security controls: timing-safe
X-Site-Tokenauth middleware, SSRF guard with OWASP controls (src/utils/safe-url.js, 248 lines), sandboxed Puppeteer launcher,express-rate-limitglobal + per-route-group limits, Helmet headers, split health endpoints with real capability detection, structured request logging (no secrets), graceful shutdown, and unit tests. Bumped to v2.2.0 withhelmet^8 andexpress-rate-limit^7.5. Plugin sidecar:WP_MEDIA_WORKER_TOKENconstant now takes priority over the option; settings page shows constant mode, warns on cleartext URLs, and links the Velocity guide. New Cloudways Velocity setup guide (docs/operations/deployment/media-worker-velocity-setup.md),.env.example, and CI workflow. (PR #5857)โ Media Worker Subtree Sync โ PR #5856 (4 files, +56/-2 lines). New
sync-media-worker.ymlGitHub Action mirrorsaddons/media-worker/to the standalonenvdigitalsolutions/mcp-ai-wpoos-media-workerrepo on pushes to main/alpha-working. Folder-level.gitignorekeepsnode_modulesout of the standalone repo history; addon README doc links switched to absolute URLs that resolve after the split. (PR #5856)โ Database Connection Pooling Stance (Proposal 023) โ PR #5855 (16 files, +2,572/-62 lines). Wave 1: Action Scheduler fallback enqueue gated when the RabbitMQ worker is active; concurrency guard slot tracking made atomic (Redis
wp_cache_incrwith InnoDBINSERT โฆ ON DUPLICATE KEY UPDATEfallback); newmcp_ai_concurrency_slotstable with daily cleanup cron. Wave 2: PDO persistent connection support in the Graphify remote SQL driver; DB polling cron gated behind the RabbitMQ transport preference; queue worker batch size configurable (--batch-size=N+ filter); Site Health checks for MySQL pool, queue depth, and RabbitMQ health. RabbitMQ admin UI: section registered with settings registry, view added to Orchestration tab navigation, brokenrender()fixed. Full spec:docs/project/proposals/023-database-connection-pooling-stance.md. (PR #5855)โ PostCSS 8.5.26 โ GHSA-6g55-p6wh-862q (1 file, +2/-2 lines).
postcssminimum bumped to >=8.5.26 inaddons/schedule-anything-spa/package.json. Version constraint only.๐ฆ Versioning โ bumped to 1.1.55 across all version-bearing files. Pro addon: 1.1.55. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 26. Bundled skills: 74 base + 41 Pro. Total coding-time agent skills: 51 (20 wp-* + 30 design-* + 1 mcp-ai-wpoos-plugin).
๐ Latest Updates (v1.1.54 โ August 2026)
August 12, 2026 โ Security Fixes, Async MCP, Skill Enhancements, README Maintenance
โ PostCSS CVE-2026-69153 โ PR #5850 (2 files, +4/-4 lines).
postcssminimum version bumped to 8.5.23 inpackage.jsonoverrides across affected addons. The CVE (high severity) allowed crafted CSS to trigger unexpected behavior in the PostCSS plugin chain. No functional changes โ version constraint only. (PR #5850)โ MCP Async Tool Response Handling โ PR #5845 (1 file, +111 lines). Fixed
tools/callendpoint dropping async tool responses. The handler was not waiting for deferred/promise-based tool execution results, causing silent failures for long-running tools (video generation, deep research, batch OCR). Now correctly awaits and serializes async results. (PR #5845)โ Plugin Updater Integrity Check v2 โ PR #5846 (1 file, +16/-2 lines). Follow-up hardening to the v1.1.52 post-install integrity check: fixed a false-positive on the
bridge/directory path caused by stale PHP stat cache, addedclearstatcache()after every file check to force fresh filesystem reads, and handled a main-file rename edge case where the old filename persisted in cache. (PR #5846)โ API Key Merged-Settings Fix for Research Tools โ PR #5852 (20 files, +37/-33 lines).
deep_research,web_search,semantic_content_search,semantic_context_search,retrieve_agent_memory,recall_memory,wake_up_context, and 13 other tools were reading API keys fromget_option('wp_mcp_ai_api_key')directly instead of using the merged credentials system. This meant per-assistant and per-provider API key overrides were silently ignored for all research operations. All 20 tools now useWP_MCP_AI_Credentials_Manager::get_merged_credentials(), which respects the provider โ assistant โ global fallback chain. (PR #5852)โ Design Skills Audit & Enhancement โ PR #5847 (61 files, +7,971/-57 lines). Comprehensive enhancement of all 22 existing
design-*coding-time agent skills with detailed operational instructions, multi-step workflow guidance, cross-references to related skills, and specific MCP tool-calling patterns. 7 new pro-toolkit skills created:design-ai-assistant-adminโ manage AI assistants, model configs, provider setup, peer mesh networkingdesign-crmโ complete CRM pipeline (leads, deals, companies, contacts, BANT/MEDDIC scoring)design-project-managementโ projects, tasks, sprints, events, task plans, PM workflowsdesign-communicationsโ multi-channel messaging (SMS, email, WhatsApp), contacts, delivery trackingdesign-servicesโ service components, dependency tracking, approval workflowsdesign-team-managementโ organizational teams, professions, role assignmentsdesign-vaultโ encrypted vault for passwords, secure notes, payment cards, digital identitiesdesign-security-opsโ security operations, audit logging, posture management Total coding-time skills: 44 (22 wp-* + 22 design-*). (PR #5847)
โ OKF YAML Frontmatter Compliance โ PRs #5844, #5849 (65 files combined). Added missing
type: Skillfrontmatter field to all 22design-*skills โ required by the OKF v0.2 trust-signal specification for concept categorization (PR #5844, +68 lines in 45 files). Fixed YAML frontmatter spec compliance violations in 9 design skills where duplicate top-level keys and invalid field structures violated the OKF v0.2 schema (PR #5849, -100 lines in 20 files). All 44 skills now pass OKF v0.2 frontmatter validation.โ README TOC Anchor Fixes โ PR #5853 (2 files). Fixed broken TOC anchor links caused by Unicode emoji rendering differences between GitHub's markdown parser and the anchor generator. VS16-based emojis (๐ชฒ๐๐๐) and U+26xx/U+27xx symbols (โ ๏ธโกโ ) now generate correct, clickable anchor links in the Table of Contents. (PR #5853)
โ Stale Build Artifacts Removal โ PR #5851 (30 files). Removed stale v1.1.52 build ZIPs and compiled assets that were superseded by v1.1.53 builds. (PR #5851)
๐ฆ Versioning โ bumped to 1.1.54 across all version-bearing files. Pro addon: 1.1.54. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27. Bundled skills: 67 base. Total coding-time agent skills: 44 (22 wp-* + 22 design-*).
๐ Latest Updates (v1.1.53 โ August 2026)
August 12, 2026 โ Shared Analytics Service, Circuit Breaker Hardening, Agent Skills Sync, SSE Fixes
โ Shared Analytics Service โ PR #5836 (18 files, +2,489 lines). New unified analytics subsystem (
addons/pro/includes/analytics/) consumed by all NV oOS Pro toolkits. 7 platform adapters: Meta (Facebook + Instagram), Twitter/X, LinkedIn, TikTok, WooCommerce, Google Analytics 4, and Cloudways monitoring. 5 immutable DTOs (Account, Post, Metric, TimeSeries, Report) with strict coercion andWP_Errorvalidation. Cross-platform normalization maps platform-specific metric names to a unified schema viaWP_MCP_AI_Metric_Normalizer. Smart caching with transient-based per-data-type TTLs and cache stampede prevention viaWP_MCP_AI_Analytics_Cache. Token-bucket rate limiter per platform viaWP_MCP_AI_Analytics_Rate_Limiterprevents API exhaustion. Extensible adapter pattern โ singleWP_MCP_AI_Analytics_Adapter_Interface, register new platforms via$service->register_adapter(). MCP server registration in the Pro toolkit fleet. Site Health integration for analytics health checks. All 8 phases complete (DTOs โ Adapters โ Service โ Tools โ Migration โ Admin UI โ MCP Server โ Site Health). Design Stack skill:design-analytics-reporting. (PR #5836)โ Circuit Breaker & Execution Pipeline Hardening โ PR #5839 (12 files, +384/-42 lines). Circuit breaker protection added to all remaining AI provider clients that lacked it โ now active on all 15 first-class providers with configurable failure thresholds and cooldown periods. Concurrency guard (
WP_MCP_AI_Concurrency_Guard) wired into the execution pipeline to prevent overlapping destructive operations across the full tool execution lifecycle. Cost tracker (WP_MCP_AI_Cost_Tracker) per-operation cost estimation now enforced at the pipeline level, not just at the provider client boundary. Backpressure signals from concurrency guard and cost tracker now feed into the agentic loop's iteration budget, automatically throttling tool calls when system load is high. Plugin updater no longer shows base-only UI after upgrade to complete (base+Pro) package. Silent build asset failure now surfaces a clear error when the complete build asset is missing from a GitHub release. (PR #5839)โ Agent Skills Sync & Discovery โ PR #5842 (1 file, +78/-24 lines).
sync-agent-skillscommand now syncs project-owned design-* skills alongside the existing wp-* skills. The 22 new design-* coding-time agent skills (design-analytics-reporting through design-video-creation) are now auto-discovered by the Zed editor alongside the wp-* WordPress development skills. Newmcp-ai-wpoos-pluginbundled skill covering complete NV oOS plugin operational guide (setup, assistant creation, MCP bridge tokens, API key bridging, Docker/WSL2 troubleshooting). Base bundled skills count increased from 45 to 67. (PR #5842)โ SSE Stream Backoff & Rate-Limit Fixes โ PR #5841 (2 files, +18/-6 lines). SSE backoff counter now properly resets between successful stream reconnections, preventing unnecessary progressive delays. Rate-limit counter correctly cleaned up after stream termination, preventing false throttling on subsequent connections. (PR #5841)
โ Load Guard Fatal Error Fix โ PR #5840 (1 file, +3/-3 lines). Fixed
WP_MCP_AI_Load_Guardcalling privatecount_active_jobs()method, causing a fatal error on PHP 8.1+ when strict visibility enforcement is enabled. Now calls the publicget_active_job_count()accessor instead. (PR #5840)๐ Documentation Catch-Up (this release) โ CHANGELOG v1.1.53 entry documenting Shared Analytics Service, circuit breaker hardening, skills sync, SSE/load guard fixes, and all changes from PRs #5836โ#5842 that were missing from the v1.1.52 entry. README updated with v1.1.53 highlights and "What's New" section. CLAUDE.md updated: Paper Store section expanded with remote/REST/discovery details, bundled skills count corrected (45โ67), circuit breaker/backpressure added to Security Infrastructure, Shared Analytics Service section added, context file references added for new docs. AGENTS.md updated: bundled skills count (45โ67), coding-time skills count (22โ44). Six
.context/files updated with August 2026 review dates and content: conventions.md (tool counts, analytics directory), tool-registry.md (list_mcp_tools, design-system preset), security-checklist.md (circuit breaker, post-install integrity check), rest-api.md (Paper Store REST endpoint), pro-vs-base.md, and .context/README.md.๐ฆ Versioning โ bumped to 1.1.53 across all version-bearing files. Pro addon: 1.1.53. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27. Bundled skills: 67 base (up from 45).
๐ Latest Updates (v1.1.52 โ August 2026)
August 11, 2026 โ Paper Store Remote, CPT Auto-Discovery, Design System Preset, Integrity Check
โ Paper Store Remote Site Support โ PR #5835 (13 files, +1,272/-73 lines). All 8 Paper Store tools (
paper_store_list,paper_store_read,paper_store_search,paper_store_write,paper_store_update,paper_store_delete,paper_store_import,paper_store_export) now accept an optionalconnection_idparameter to proxy operations through Remote Site Manager. New REST API controller atmcp-ai/v1/paper-store(697 lines) with full CRUD + search + import/export endpoints for remote site access. NewWP_MCP_AI_Paper_Store_Remotetrait (96 lines) handles HTTP dispatch and response normalization. Newlist_mcp_toolsdiscovery tool (234 lines) enables AI agent self-discovery โ returns all available MCP tools with JSON Schema parameter definitions, filterable by toolkit namespace and search term. (PR #5835)โ Remote Connection CPT Auto-Discovery โ PR #5834 (1 file, +16/-4 lines). Plugin-registered custom post types (including
paper_store) now appear automatically in remote connection post type access controls viaget_post_types(). Users no longer need to manually type each CPT slug, save, and reopen.resolve_post_type_access()mirrors the same discovery logic on form submission. Multi-Site Gateway plan (docs/project/plans/multi-site-gateway-plan.md, 1,429 lines) for hub-and-spoke federation targeting v1.5.0+. (PR #5834)โ Design System Tool Preset โ PR #5837 (1 file, +108 lines). New
design-systempreset inWP_MCP_AI_Tool_Presets_Helperwith 72 tools across 13 categories: WordPress content (9), image generation (4), image analysis (4), image processing (5), web search/research (5), charts (2), document generation (14), Paper Store (8), video generation (2), video processing (5), social media (3), AI/memory (6), and utility (4). (PR #5837)โ Post-Install Integrity Check โ PR #5833 (1 file, +74 lines).
WP_MCP_AI_Plugin_Updaternow runsverify_installation_integrity()after every update, checking 15 critical file paths against the plugin directory before reporting success. Prevents silent update corruption on distributed filesystems (Cloudways) whereunzipcan drop files without errors. REST controllerrequire_oncecalls now guarded withfile_exists()checks. (PR #5833)โ Pro Update Visibility Fix โ PR #5832 (1 file, +10 lines). Pro addon update section now visible for wp.org base + standalone Pro plugin installs.
โ Docker Chmod Suppression โ PR #5831 (3 files). Suppressed
chmod()warnings during plugin install in Docker environments by checking filesystem constants.๐ Documentation โ 3 new feature docs: Paper Store, Remote Sites & Connections, MCP Protocol Version Negotiation. Updated: Tool Presets System (Design System preset), Plugin Updater (integrity check), DOCUMENTATION_INDEX, QUICK_REFERENCE, README, CHANGELOG.
๐ฆ Versioning โ bumped to 1.1.52 across all version-bearing files. Pro addon: 1.1.52. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27.
๐ Latest Updates (v1.1.51 โ August 2026)
August 11, 2026 โ Orchestration Gap Remediation, MCP Version Negotiation, Media Worker Security Bumps
โ Orchestration & Harness Layer Gap Remediation โ PR #5830 (28 files, +3,295/-29 lines). Comprehensive audit of AI orchestration and LLM harnessing subsystem against August 2026 industry standards โ OWASP LLM Top 10, EU AI Act, NIST AI RMF, MCP/A2A protocols, and OpenTelemetry GenAI conventions. OWASP LLM Top 10 coverage: 20% โ 60%. EU AI Act compliance: 17% โ 67%. Six new classes:
WP_MCP_AI_Output_Guardrail(338 lines, OWASP LLM05 โ validates LLM responses for PII, credentials, unsafe content before downstream consumption),WP_MCP_AI_Citation_Verifier(295 lines, OWASP LLM09 โ cross-references claims against source documents to detect hallucinations),WP_MCP_AI_Model_Integrity_Verifier(274 lines, OWASP LLM03 โ supply chain security with blocked model list and TLS verification),WP_MCP_AI_Semantic_Cache(289 lines, two-tier prompt caching: exact-match + embedding-based similarity),WP_MCP_AI_Canary_Deployment(404 lines, progressive model rollout with automatic rollback on threshold breach). Workflow Engine V2 graduated from feature-flag to GA release. Red Teaming scripts:bin/red-team.php(160 lines, 9 probe categories) andbin/red-team.sh(172 lines, 6 attack vectors). Harness init registers Output Guardrail + Citation Verifier by default. Three new docs: Orchestration & Harness Reference (202 lines covering all 10 layers AโJ, protocols, security, observability, and 2026 standards alignment), EU AI Act Compliance Mapping (Articles 13โ15, 50, 52), and OWASP LLM Top 10 coverage matrix. OWASP coverage: 20% โ 60% | EU AI Act: 17% โ 67% | Overall: ~65% โ ~82%. All PHPCS checks pass with zero errors. (PR #5830)โ MCP Protocol Version Negotiation โ PR #5829 (2 files, +123/-3 lines). Older MCP clients (Zed, Claude Desktop, Cursor) rejected the hardcoded
2026-07-28protocol version.class-wp-mcp-ai-rest-mcp-methods.php(+77 lines) andclass-wp-mcp-ai-toolkit-mcp-rest-controller.php(+49 lines) now negotiate the highest version both server and client support, falling back to2024-11-05when the client provides no version information. Maintains full backward compatibility. (PR #5829)โ Security Bumps โ Media Worker โ PR #5828 (2 files, +11,728/-3 lines). multer 1.4.5-lts.1 โ 2.2.0 (deprecated 1.x line with multiple DoS vulns patched). nodemailer 8.0.5 โ 9.0.5 (GHSA-p6gq-j5cr-w38f: raw header bypass fixed in 9.0.1). sharp 0.33.0 โ 0.35.3 (libvips CVE-2026-33327 and related CVEs fixed in 0.35.0). No code changes required โ all three packages maintain backward-compatible APIs across the version bumps. (PR #5828)
๐ฆ Versioning โ bumped to 1.1.51 across all version-bearing files. Pro addon: 1.1.51. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27.
๐ Latest Updates (v1.1.50 โ August 2026)
August 10, 2026 โ Media Worker Sidecar, Site Health Fix, NPM Security, BMAD Agent Updates
โ Media Worker Sidecar โ PRs #5822, #5823 (132 files, +6,283/-2,779 lines). New
addons/media-worker/package providing a Docker-based Node.js sidecar that offloads heavy media processing from WordPress. Uses a service cascade pattern with Express routing across 11 handlers: browser (Puppeteer-based automation), code (sandboxed execution), data (transformation/ETL), document (generation/conversion), email (rendering/sending), image (manipulation/optimization), ocr (Tesseract-based), pdf (generation/manipulation), social (cross-platform posting), video (transcoding/extraction), and workflow (pipeline orchestration). Queue module (src/queue.js, 217 lines) with concurrent processing, retry logic, and Jest test suite. Pro integration:WP_MCP_AI_Media_Worker_Settings(256 lines) for admin configuration,WP_MCP_AI_Media_Worker_Clienttrait (219 lines) for tool-to-sidecar communication. Docker service name to private IP resolution in loopback detection (includes/class-wp-mcp-ai-http-helper.php).docker-compose.ymlupdated with media-worker service. Pro services updated (Fluent FFmpeg, Language Detection, MJML, Nodemailer, OCR, Prettier, Video Frame Extractor) and tools (export calendar ICS, analyze geospatial, generate health chart, render math equation). Documentation: deployment guide (280 lines) and proposal (237 lines).โ Site Health Redeclaration Fix โ PR #5824 (1 file). Fixed PHP fatal error from function redeclaration in
ensure_site_health_dependencies()insideincludes/tools/class-wp-mcp-ai-tool-get-site-health.php. Now guarded withfunction_exists(). (PR #5824)โ NPM Security Fixes โ PR #5821 (12 files). Resolved nanoid, js-yaml, and dompurify vulnerabilities across 11+ addon
package-lock.jsonfiles (chat-spa, cloud-worker, comic-reader, docs-hub, document-editor, media-studio, pro/spa, pro/spa-v2, saas-controller, schedule-anything-spa, tenant-router, toolkit-shell). (PR #5821)โ BMAD Agent Editing Conventions โ PR #5825 (2 files). Developer and QA agent YAMLs (
.bmad/agents/nv-oos-developer.yaml,.bmad/agents/nv-oos-qa-engineer.yaml) updated with code editing conventions for consistent agent behavior during file modifications. (PR #5825)โ WPCS Formatting Cleanup โ repository-wide. PHPCS fixes applied across all PHP files: tabs, docblock formatting, and code style corrections. No functional changes.
๐ฆ Versioning โ bumped to 1.1.50 across all version-bearing files. Pro addon: 1.1.50. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27.
๐ Latest Updates (v1.1.49 โ August 2026)
August 8, 2026 โ Gemini Model Fix, Update Reactivation, Release ZIP Cleanup
โ Gemini Model Resolution Fix โ PR #5817 (1 file, 2 lines).
includes/class-wp-mcp-ai-gemini-client.phpโ model resolution now uses the correct settings key instead of the deprecated fallback. The oldgemini-promodel fallback has been removed; all Gemini model lookups now go through the canonical provider settings path. (PR #5817)โ Update Reactivation & Release ZIP Cleanup โ PR #5816 (68 files, +164/-18 lines).
includes/class-wp-mcp-ai-plugin-updater.php(+152/-18 lines) โ update reactivation flow fixed; plugin now correctly handles post-update reactivation. Nonce-scoped update actions hardened..distignoreand.gitattributesupdated to exclude development-only files (.agents/,.context/,.github/, IDE configs, test fixtures) from release ZIPs.bin/build-plugin-zip.shupdated with new exclusion rules. Minor fixes in OCR service, research report generator, research project tool, video analysis service, and 5 image-analysis tools. (PR #5816)๐ฆ Versioning โ bumped to 1.1.49 across all version-bearing files. Pro addon: 1.1.28. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27.
August 8, 2026 โ Shopify Sync Toolkit Fixes, PHPCS Security, Skill Catalogues (v1.1.48)
โ Shopify Sync Toolkit โ 7 Fixes (PR #5815, 6 files). Fatal error fix:
graphql_query()โgraphql()in Admin API connection test. Deadlist_by_statuscode removed โ replaced two brokenper_page => 1loops with a directSELECT COUNT(*) WHERE status = %s. Always-zero analytics count now usescount($edges)from the actual API response. Duplicateget_option()call and redundant$sync_modeassignment removed. Infinite loop risk eliminated โ paginatedtruncate()while-loop replaced with directDELETE FROM {table}SQL. Double DB query per upsert halved โupsert()now accepts a by-reference&$operationoutput parameter. Missingorderby/orderschema parameters added with sanitization passthrough.โ PHPCS CVE-2026-67434.
squizlabs/php_codesnifferbumped 3.13.4 โ 3.13.6 in all 3composer.lockfiles. Resolves arbitrary code execution via crafted ruleset XML. Dev dependency only โ no functional impact.โ Default Skill Catalogues. Brave Search Skills and all 22 WordPress Agent Skills added to default skill catalogue for new assistants out of the box.
โ NVoOS Graphify Standalone Plugins. 3 new standalone plugin ZIPs in
plugins/directory: Graphify v1.0.1, Graphify AI Platform v1.0.0, and Graphify AI v1.0.0.๐ฆ Versioning โ bumped to 1.1.48 across all version-bearing files. Pro addon: 1.1.28. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live registry authoritative). Provider count: 15 first-class language-model providers. Addon count: 27.
August 7, 2026 โ MySQL Connection Exhaustion Fix, Update Cache Bust, Mermaid Security (v1.1.47)
โ MySQL Connection Exhaustion Fix (Cloudways) โ PR #5809 (7 files, +438/-89 lines). Cron system overhaul in
includes/bootstrap/cron.phpโ unified concurrency limits, per-process memory caps, and staggered offset scheduling prevent connection-pool saturation on Cloudways and similar hosts with restrictive MySQL connection limits. Each cron hook now respects a concurrency ceiling and memory budget before forking additional workers. Activation bootstrap (includes/bootstrap/activation.php) updated with resource-aware connection throttling โ batched queries with explicit connection release during activation. Service status registry (includes/class-wp-mcp-ai-service-status-registry.php) hardened with transient caching to reduce database round-trips during status polling. Maintenance CPT streamlined. Pro status page: JS improvements (+99 lines), AJAX handler enhancements (+74 lines), dashboard fixes. (PR #5809)โ Update Checker Cache Bust โ PR #5810 (1 file, +6 lines).
ajax_check_update()andajax_check_pro_update()inincludes/class-wp-mcp-ai-plugin-updater.phpnow delete cached release data before fetching from the GitHub Releases API. Manual "Check for Updates" clicks always return live data instead of the stale 12-hour TTL cache.โ Mermaid Security Fixes (1 addon, 2 files). npm audit fix in
addons/canvas-toolkit/: mermaid 11.15.0 โ 11.16.1 resolves 5 CVEs (GHSA-3rrr-jr9j-h3q3 prototype pollution, GHSA-6x64-9x62-f2gx CSS injection, GHSA-rhh3-jpg6-66xh radar DoS, GHSA-2v8p-3f2j-5mp7 XY Chart DoS, GHSA-c4c3-pg64-4m4v config prototype pollution). Transitive bumps: dompurify 3.4.12 โ 3.4.13, nanoid 3.3.16 โ 3.3.18. Canvas toolkit dist bundle regenerated. Zero functional impact โ mermaid mode is an unused stub.๐ฆ Versioning โ bumped to 1.1.47 across all version-bearing files. Pro addon: 1.1.27. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27.
๐ Latest Updates (v1.1.46 โ August 2026)
August 5โ6, 2026 โ Backup & Restore, Plugin Updater, Abilities API, Status Page Fixes, PHPCS Cleanup
โ Comprehensive Backup & Restore โ Proposal 020 (14 files, +3,660 lines). New modular export system with export manager (512 lines) and 11 export providers (8 base + 3 Pro). Base providers: Core Settings (258 lines), Assistants (285 lines), CPTs (319 lines), Custom Tables (394 lines), Federation (253 lines), Addon Options (337 lines), Toolkit Options (282 lines). Pro providers: JetEngine CCTs (329 lines), License keys (190 lines), Remote Sites (324 lines). All implement
WP_MCP_AI_Export_Provider_Interfacewithexport()andimport()methods. JSON-based export/import with chunked file I/O and progress reporting. Admin UI in Settings โ Advanced expanded by 638 lines with provider checkboxes, export/import buttons, and progress feedback. Subsystem architecture documented inincludes/admin/export/README.md(202 lines). Proposal 020 includes proposal (308 lines) and implementation plan (1,249 lines). (PRs #5805, #5807)โ GitHub-Based Plugin Updater โ 5 PRs, +772 lines. New
WP_MCP_AI_Plugin_Updaterclass fetches release metadata from the GitHub Releases API, compares versions against installed, downloads ZIP artifacts, and installs updates via WordPressPlugin_Upgrader. Base-to-complete upgrade path added to Settings โ Advanced โ one-click upgrade from base-only to complete package. Pro addon update support detects and updates the Pro addon alongside the base plugin when bundled; hides redundant Pro updater UI when already included. Core updates usePlugin_Upgrader; Pro updates use direct copy with rollback. Nonce-scoped update actions with proper capability checks. WPCS formatting and phpcs:ignore annotations for pre-existing nonce warnings in updater files. (PRs #5800โ#5804)โ Abilities API Selective Adoption โ Proposal 019 (11 files, +2,364 lines). New
includes/abilities/framework introducing machine-readable plugin operations with JSON Schema contracts for AI agent and MCP tool discovery. Registrar (188 lines) for ability registration/discovery/lifecycle. Bridge (235 lines) connecting abilities to the tool registry for MCP and AI agent discovery. Category Registrar (92 lines) for hierarchical ability grouping. Security Bridge (289 lines) providing capability-based access control per ability. NewWP_MCP_AI_Tool_Ability_Interface(61 lines) โ contract for tools exposing discoverable abilities. Bootstrap integration atabilities-init.php(49 lines). 5 PHPUnit test files: backward compatibility (139 lines), bridge (279 lines), registrar (190 lines), category registrar (96 lines), mock tool (158 lines). Reference documentation atdocs/reference/abilities-registry.md(106 lines). Folder README atincludes/abilities/README.md(33 lines). Proposal 019 includes proposal (220 lines), implementation plan (452 lines), and appendix (580 lines). OOS Bridge Wave 2 updated with new tool registry integrations. (PR #5799)โ Status Page Fixes โ 2 files, +108 lines. Fatal error in Pro status REST endpoint resolved โ missing methods in
class-wp-mcp-ai-pro-status-ajax.phpcausing 500 errors on status API calls. JavaScript errors on the status dashboard page fixed with proper i18n text domain consistency.pro-status-page.js(32 lines changed) andpro-status-dashboard-page.php(12 lines changed). (PR #5806)โ Knowledge Base Auto-Build. CI workflow auto-builds
knowledge-base.zipwhen playbook files change, ensuring the packaged knowledge base stays current with the profession registry. (PR #5797)โ PHPCS Cleanup & Canonical Envelope Compliance. Remaining parse errors from the canonical envelope conversion resolved across tool files. Text domain mismatches (
mcp-ai-wpoosvsmcp-ai-wpoos-pro) corrected across Pro tool files. WPCS indentation, alignment, and inline comment fixes applied to 100+ files across base, Pro, and core tool directories. (PRs #5798, #5804)๐ฆ Versioning โ bumped to 1.1.46 across all version-bearing files. Pro addon: 1.1.29. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27. Knowledge base: 311 professions (12 industry categories).
๐ Previous Updates (v1.1.45 โ August 2026)
August 5, 2026 โ Self-Hosted OCR, Embedded v0.2.0, AI Transparency, Graphify, Build Automation
โ Self-Hosted OCR (Unlimited-OCR + DeepSeek-OCR) โ Proposal 018 (17 files, +4,087 lines). New unified vLLM client class supports both Baidu Unlimited-OCR (3B, MIT, 93.23% OmniDocBench) and DeepSeek-OCR (~3B, MIT) via self-hosted GPU infrastructure. Both models share the same integration pattern (vLLM + OpenAI-compatible REST API + NGramPerReqLogitsProcessor). New Pro tools:
pro_unlimited_ocr(dedicated long-horizon OCR with structured output modes โ text/structured/raw, table extraction, form field detection, Paper Store persistence) andpro_batch_ocr(Action Scheduler batch processing, sync up to 10 docs, async up to 100). Structured extraction service with marker parsing, table/form-field extraction. Existingextract_image_text(Base) andpro_document_ocr(Pro) tools now includeunlimited_ocranddeepseek_ocras provider enum values. Admin settings: two new endpoint URL fields with AJAX Test Connection buttons. OCR client: 640 lines.โ Embedded Addon v0.2.0. Backend registry expanded with voice tool calling, OpenMed healthcare tools, and new MCP โ CCT Stability, Proposal 016+017 Hardening, API Key Fixes, Docs ๐๐ก๏ธ๐๐
โ CCT Stability Fixes (4 PRs). CCT duplicate registration race condition resolved with database-backed mutex lock (
wp_mcp_ai_cct_registration_mutexoption). FlowHub CCT duplicate registration corrected โ second menu title entry removed, registration guard now checks for existing CCT before attempting re-registration. Base plugin fatal error whenlib/core/is absent (require_onceof non-existentPlatformFlushInterface.php) โ now guarded withfile_exists()check, plugin continues gracefully without core features.โ API Key & Provider Fixes (2 PRs). Gemini API key resolution in video services (
generate_video_via_veo,generate_video_via_imagen) restored after the v1.1.43 credential split moved keys towp_mcp_ai_credentialsoption. Veo fallback chain now correctly forwards async context parameters (task ID, poll URL) between fallback attempts โ fixes silent failures when primary model is unavailable. Omni API endpoint URL corrected. Audio completion hook registration fixed.โ Security & Architecture Hardening โ Proposal 016 (all waves). 277
require_oncecalls for class-only files wrapped inspl_autoload_registerconditional โ reduces filesystem stat calls on every request. Autoload class-name heuristic corrected to stripwp_mcp_ai_prefix from file names before resolution. Repository-wide phpcs auto-fix applied (trailing commas, blank lines, Yoda conditions, short array syntax). Docker QA container vendor mismatch fixed (runscomposer install --no-devinside container). All medium-severity findings addressed (error-log guarding, auto-index detection, debug output gate). 6 low-severity findings resolved (DNS info leak, master-key constant, version-drift alignment, shell-command denylist documentation, orphaned comment removal).โ Polling, Queue & Load Balancing Hardening โ Proposal 017. Twelve structural weaknesses across three subsystems: polling timeout inconsistencies resolved with unified 30s cap; queue worker deduplication via
wp_mcp_ai_queue_locktransient; load-balancer health-check interval standardized to 15s with jitter. Stale.php.bakbackup file removed (was shadowing the real class file and causing ambiguous resolution).โ Deferred Security Items (#5755, items 5โ7). Post meta values escaped via
esc_html()before rendering in admin tables. Term description output hardened withwp_kses_post(). REST response field list filtered to remove internal-only debug keys (_debug_trace,_internal_state).โ Docs & Ecosystem.
FOR_REVIEWERS.mdupdated for v1.1.43: total tool count ~1,500 (~263 base + ~1,232 Pro), 10 security classes, security posture status refreshed. 16 broken cross-reference links fixed across 5 docs files after the July docs reorganization. Graphify ecosystem audit completed: wp.org Plugin Check compliance verified, migration gap analysis documented, chat shortcode integration plan with NV oOS REST endpoints drafted.โ npm Security โ Dependency Override Floors.
undici>=8.10.0(5 HIGH + 4 MODERATE CVEs) applied across 11 package.json files.fast-uri>=3.1.4(CVE-2026-16221 backslash authority confusion) across 3 package.json files.ip-address>=10.4.0(IPv4-mapped/NAT64 SSRF bypass + CIDR suppression) across 3 package.json files. All 11 package-lock.json files regenerated vianpm install --package-lock-only.๐ฆ Versioning โ bumped to 1.1.44 across all version-bearing files. Pro addon: 1.1.27. Tool count: ~263 base + ~1,232 Pro (~1,500 total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27. Knowledge base: 311 professions (12 industry categories).
๐ Previous Updates (v1.1.43 โ August 2026)
July 30โAugust 1, 2026 โ MCP Protocol Upgrade, Security Hardening, OKF v0.2, ICP System, Sync Fixes ๐๐๐๐ฏ๐ง
โ Security Hardening v1.1.43 (16 files, 427 additions). SSRF protection across 7 provider connection handlers (blocks cloud metadata endpoints + private IPs). A2A agent URL SSRF guard with federation peer allowlist. SQL table-name regex validation for injection defense. A2A per-assistant agent cards now require authentication (was publicly exposed). Chat SPA /config and /manifest endpoints changed from
__return_truetologged_in_permission. Missing args schemas on 7 REST endpoints (voice, security center, chat transcripts, A2A webhook). Guest rate-limiting changed from shared counter to IP-based hashed keys (DoS vector closed). 3 tool capability mismatches corrected (check_site_security,delete_cron_job,purge_cache). Centralized defense-in-depth capability gate in Tool Registry. PHP object injection prevention viasafe_unserializehelper withallowed_classes => false. Post meta/term output escaping hardened.โ MCP Protocol Upgrade (2026-07-28). Largest MCP revision since launch โ stateless core removes sessions and
initialize/initializedhandshake (SEP-2567, SEP-2575). Newserver/discoverRPC for capability probing._metaper-request for protocol version, client identity, capabilities.Mcp-Method/Mcp-Nameheaders on Streamable HTTP (SEP-2243). TTL/cache-scope ontools/listresponses (SEP-2549). Legacy client shim preserves backward compatibility. 10 files changed. SSE transport preserved (deprecated per SEP-2596, 12-month off-ramp).โ OKF v0.2 Trust-Signal Support. Indentation-aware recursive descent parser replacing flat frontmatter. Inline YAML mappings, nested object lists, flow sequences. Reader:
get_trust_tier()(unverified/machine-confirmed/human-reviewed),is_stale(), extendedsearch()with trust filters. Writer:validate_bundle()checks v0.2 fields. New tool:okf_validate_attestation. All 6 existing OKF tools surface trust signals. 15 files, 27 standalone smoke tests. Full backward compatibility with v0.1.โ Pro Module Registry (Architecture).
wp_mcp_ai_pro_init()decomposed from ~625-line monolithic init function into a PSR-4 module registry. Per-module loading with dependency ordering. Graceful degradation when modules or their dependencies are unavailable. Fixes broken require paths that causedclass not foundfatals under certain load orders.โ ICP System (Pro CRM Phase G). Data-driven Ideal Customer Profile system with 7-dimension scoring engine (Firmographic 25%, Technographic 20%, Intent 15%, Engagement 15%, Buying Triggers 10%, Economic Outcome 10%, Negative Signals 5%) โ fit+intent separation, behavioral decay, negative disqualifier scoring. 2 new MCP tools:
compute_icp_score(score Company/Lead CPTs or manual data) andmanage_icp_profile(CRUD via AI). Admin UI with profile list table and 7-tab weighted editor.โ Profession & Playbook Sync Fixes (7 PRs). Playbook: bulk sync silent failures now report
{synced, errors}to admin UI. Force-regenerated playbook files no longer incorrectly deleted. Undefined array keyorphaned_attachmentsin playbook stats fixed. Test Model page assistant dropdown restored. Profession: duplicate slug detection in knowledge base JSON files (312โ311 entries). Title fallback matching preventsUpdatefrom creating duplicate posts when slugs change between versions. Consumed-post collision fix ensures all unique KB entries create distinct posts (resolves 310-published vs 311-KB mismatch).โ Hexagonal Architecture Purity (PlatformFlushInterface). Last WordPress reference removed from
nvoos/corelibrary. NewPlatformFlushInterfacecontract inlib/core/, WordPress adapter inincludes/bridge/. SseHandler now receives flush interface via constructor injection โ zero framework dependencies remain.โ Phase 3 Operational Security Hardening. Audit logger REST route hook corrected from
inittorest_api_init. Security posture signal coverage hardened.โ Dependency Updates.
wp-coding-standards/wpcsbumped to 3.4.1 for CVE-2026-45293. Dev tooling: replaced hardcoded Intelephense LSP with Phpactor in Zed settings.๐ฆ Versioning โ bumped to 1.1.43 across all version-bearing files. Tool count: ~201 base + ~830+ Pro (~1,031+ total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27. Knowledge base: 311 professions (12 industry categories).
๐ Previous Updates (v1.1.42 โ July 2026)
July 23โ29, 2026 โ Security Infrastructure, Framework-Agnostic Core, Status Page, Agent Skills, Algorave ๐ก๏ธ๐๏ธ๐ก๐ค๐ต
โ Security Infrastructure Hardening (4 PRs). 7 new security infrastructure classes: Request Guard (SSE limits, JSON depth, body size, error verbosity, asset version stripping), Security Posture (21 signals, 0-100 weighted score, A-F grading), Destructive Ops Gate (confirmation gate), URL Guard, Concurrency Guard, Cost Tracker, API Key Store. Site Health checks for cron + security posture. 13 new security unit tests covering API key encryption, auth split-brain, break-glass, credentials expiry, destructive ops, rate limiting, SSE auth/CORS/rate limiting, SSRF protection, tool scope sanity, URL guard, and validated upload.
โ Security Defaults & Headers Hardening. CORS configurable origin control (new cors_restricted posture signal, weight 5). Auth brute-force protection with rate limiting (new auth_brute_force_on signal, weight 4). Error verbosity three-tier filtering Safe/Moderate/Debug (new error_verbosity_safe signal, weight 4). Request body size enforcement (new body_size_limited signal, weight 3). OAuth token lifetime admin control, guest scope docs, SSE CORS filter, webhook secret indicator. DICOM PHI auto-redaction filter. Asset version stripping. Centralized exception guard.
โ Security Dashboard Posture Signals. Dynamic signal count replaces hardcoded 17. Accurate audit-log empty-state text. CORS origin preview in header tool. Production hardening guide with WAF/OAuth/DICOM checklist.
โ Framework-Agnostic Core (lib/core/). nvoos/core package with Hexagonal Architecture (Ports & Adapters), PHP 8.1+, separate composer.json. 32 domain contracts covering chat, caching, content, cost tracking, cron, email, events, files, HTTP, memory, models, OCR, providers, speech, streaming. 21 WordPress adapters. ChatOrchestrator with RateLimiter + SemanticCompressor. ProviderRouter (12-provider routing). Framework-agnostic ToolRegistry + SkillRegistry. 109 tools migrated to nvoos/core format. 5 chat parity gaps closed: finish_reason handling, prompt caching, input sanitization, vision image processing, transcript store contracts.
โ Status Page & Incident Communication (Pro). Maintenance window CPT with REST CRUD, frontend banner + countdown timer, email/webhook/channel broadcast notifier. Incident CPT with phase state machine, phase-aware notification dispatcher, incident-to-lesson bridge. 4 new AI tools: get_service_status, create_incident, update_incident, resolve_incident.
โ Agent Skills & BMAD Agents. 21 coding-time agent skills (.agents/skills/) for Zed editor covering WordPress plugin development patterns โ abilities API, action scheduler, HTML API, i18n audit, plugin architecture, assets loading, bootstrap, cron, DTO, hooks, lifecycle, options storage, presenter, rewrite rules, query cache, REST API, security audit (with reference doc), security deep, security secrets, UTF-8 text. 6 BMAD workflow agent YAML definitions (.bmad/agents/) โ analyst, architect, developer, product-manager, qa-engineer, scrum-master โ with team composition config. Full .context/ subsystem context system with 8 topic files + 5 templates + active/archive directories.
โ Algorave Addon. New standalone addon for live coding and algorithmic music generation. 9 tools: export-midi, generate-music-ai, generate-pattern, midi-output, modify-pattern, play-control, sample-manager, strudel-reference, visualizer. Pattern and session CPTs. REST API. Admin settings.
โ Critical Bug Fixes. Request Guard wrap_dispatch parameter order mismatch with WP >= 6.5 rest_dispatch_request filter (was causing fatal error). Nonce authenticator now accepts _wpnonce query parameter in addition to X-WP-Nonce header (fixes 401 on legacy chat client streams).
โ Dependency Security Updates. brace-expansion overrides across all addons. js-yaml and postcss security overrides. All npm lock files regenerated. undici pinned to 7.x for Node 20 compat in canvas-toolkit.
๐ฆ Versioning โ bumped to 1.1.42 across all version-bearing files. Tool count: ~201 base + ~830+ Pro (~1,031+ total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27 (new: Algorave).
July 20โ22, 2026 โ OKF Integration, Security Compliance, Playbook Sync, Model Credentials, Dependency Bumps ๐๐๐ง๐๐ก๏ธ
โ OKF Integration (Open Knowledge Format v0.1). Pure-PHP YAML frontmatter parser and bundle reader/writer with atomic concept CRUD and conformance validation. 6 new MCP tools: okf_read_concept, okf_browse, okf_traverse, okf_search, okf_write_concept, okf_delete_concept. All 41 bundled skills now OKF v0.1-conformant. Zero new Composer dependencies.
โ Security Compliance (11 HIGH/P0 Fixes). HMAC-signed policy tokens for professional selector with 1h expiry. Health endpoint auth-gating (public response reduced to status only). ZIP path traversal prevention with realpath() containment. CSRF nonces on Shopify/EZuite/FlowHub sync endpoints. CDN SRI integrity hashes for all 6 libraries. Google Chat OIDC hardening with shared-secret token. Privacy imaging path traversal fix. Autoload fallback cleanup. Version alignment across all package.json files.
โ Playbook Sync Fixes. Duplicate AJAX handler conflict resolved with nonce-aware cap bypass. CPT class loading guard in remove_duplicate_playbooks(). Silent sync failure detection โ sync_all() now returns {synced, errors} surfaced to admin UI. Profession prompt regression fixed after HMAC refactor.
โ Model Provider Credential Resolution. Model_Service now resolves API keys from all 4 sources โ settings, credentials option, environment variables, and PHP constants โ via Credential_Resolver.
โ Dependency Security Bumps. adm-zip >=0.6.0 (ZIP CVE), axios >=1.18.0 (6 CVEs), brace-expansion 1.1.16/2.1.2/5.0.7 across 5 package.json files (CVE-2026-13149). npm audit: 0 vulnerabilities. composer audit: 0 advisories.
๐ฆ Versioning โ bumped to 1.1.41 across all version-bearing files. Tool count: ~201 base + ~830+ Pro (~1,031+ total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 26.
๐ Previous Updates (v1.1.40 โ July 2026)
July 12โ15, 2026 โ Content Format Awareness, Research Pipeline, Settings Credential Split, Model Catalog, Provider Parity, SSE Fixes
โ Content Format Awareness. New
WP_MCP_AI_Content_Format_Helperclass (585 lines) detects and preserves Markdown, HTML, and plain text formats across post-modifying and analysis tools. Full 582-line test suite.โ Research โ Paper Store โ WordPress Draft Pipeline. All research tools support
save_to_paper_storeparameter. Newcreate_post_from_researchPro tool. New action hooks. Backward-compatible.โ Settings Credential Split. Sensitive API keys moved to separate non-autoload
wp_mcp_ai_credentialsoption with transparent merge viaget_settings(). One-time migration. Defense-in-depth withwp_suspend_cache_addition. Settings import/export batch fixes (4 PRs).โ Demo Video Pipeline Complete (Phases 0โ5). Scripted scene recording with AI voiceover. GitHub Actions CI workflow. 14 narration scripts.
โ Kimi & DeepSeek Client Parity. Full streaming, tool use, and token tracking parity. DeepSeek and 9 missing providers added to all research tools.
โ Model Catalog Update (July 2026). 24 files across base + pro. Default bumps: Gemini
gemini-2.5-flashโgemini-3.5-flash, NVIDIAmeta/llama-3.1-8bโnvidia/nemotron-3-nano-30b-a3b, Gemini Livegemini-2.5-flash-liveโgemini-3.1-flash-live-preview.โ OOS Engine: SchemaStoreInterface + Tests. New domain contract, entities, tool, and WordPress adapter. 45 new unit and integration tests.
โ SSE HTTP/2 Fixes.
ob_clean()replacesob_flush(). 524 timeout resolved in Pro SPA v2.โ Vector Store Sync No Polling. Status checked only on assistant change and page load.
โ Validated Tool Slug Allowlist fix (PR #5680).
๐ฆ Versioning โ bumped to 1.1.40 across all version-bearing files. Tool count: ~195 base + ~830+ Pro (~1,025+ total; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 26.
๐ Previous Updates (v1.1.39 โ July 2026)
July 10โ13, 2026 โ Meta-Harness Auto-Optimization, Agent Delegation Rework, Pro SPA v2 Polish, Tool Presets Refactor, CRM Enhancements ๐ง ๐๐ฌ๐๏ธ๐
โ Meta-Harness Auto-Optimization System (All 7 Phases). New self-improving agent infrastructure: Trace Store + Trace Capture for execution telemetry (Phases 0-1); Harness Search Engine for telemetry querying (Phase 2); Pro Coding-Agent Proposer for automated improvement suggestions (Phase 3); Cues, Population, Auto-Deploy, and DSpark orchestration (Phases 4-6); comprehensive test coverage (Phase 7). Enables plugins to observe, analyze, and self-optimize AI agent execution.
โ Agent Delegation โ Major Rework. Delegation now runs inline instead of async for immediate results. REST-based dispatch via chat endpoint replaces no-op role executor. Cron resilience: delegation jobs no longer silently fail without retry.
spawn_cron()added afterwp_schedule_single_eventfor instant deferred job execution. Name-based agent resolution indelegate_to_agenttool. Wire-up and tasks drawer fixes in SPA v2.โ Pro SPA v2 โ Polish & Fixes (20+ PRs). Vector store indicator and slash autocomplete positioning (PR #5666). Double path in vector store preload URL fixed (PR #5665). TDZ crash in CommandAutocomplete resolved (PR #5664). Inline command autocomplete and Zed-style refresh (PR #5663). Cost badges restored in response UI (PR #5661).
allowSensitiveToolsconfig propagated to chat-spa, Pro SPA v2, and delegation dispatch (PR #5658). Tool result rich rendering, sidebar auto-refresh, and media cache-busting (PR #5651). Auto-save transcripts ononFinishcallback (PR #5650). Attachment support, save button, and storage display (PR #5646). Tasks drawer toolbar button with failedCount badge (PR #5642). Speech/audio tool response envelope fix (PR #5636). Capability flags rendering fix (PR #5635). Usage badges and image+text rendering fix (PR #5634). Sidebar media panel visibility and ID column (PR #5633). Media insert button + speech button reposition (PR #5632). System prompt leak, sidebar empty state, media-to-chat bridge (PR #5631). Tool display and conversation duplication fix (PR #5626). Composer mobile bottom padding (PR #5625). Media grid flexbox layout fix (PR #5624).โ Tool Presets Refactor. Essentials layers added, duplication stripped, auto-upgrade for validated variants (PR #5660). Validated tool auto-upgrade no longer causes duplicate names and not-allowed errors (PR #5662). Double tool execution fixed in SSE adapters with media refresh filter clear (PR #5652).
tool_call_idfallback for DeepSeek streaming and SPA v2 tool results (PR #5638). Save button added, tool messages withouttool_call_idstripped (PR #5648). Tool message block indentation auto-fixed (PR #5638).โ CRM Enhancements. CRM cache loop fixed (PR #5645). Upwork rate limiting (PR #5645). Freelance Platforms & External Sourcing configuration enhanced (PR #5639).
โ Infrastructure. Veo 2.0 deprecated โ Gemini Omni Flash replacement (PR #5667): migration path, deprecation detection preventing wasteful 404 fallback loops, user-facing error messages recommending
gemini-omni-flash(10s duration, native audio, multi-turn editing), cost calculator updated, tool schema defaults updated, admin settings updated, tests updated. Workflow auth and protected method errors fixed (PR #5659). ZAP scan Docker network isolation resolved (PR #5637). npm packages rebuilt and built assets updated (PR #5653).โ Documentation. Comprehensive OpenMed integration plan v2 added (PR #5641).
๐ฆ Versioning โ bumped to 1.1.39 across
mcp-ai-wpoos.php,WP_MCP_AI_VERSIONconstant (includes/bootstrap/constants.php),readme.txt,README.md,CHANGELOG.md,QUICK_REFERENCE.md,ROADMAP.md, andDOCUMENTATION_INDEX.md. Tool count: ~195 base + ~830+ Pro (~1,025+ total; live count viaWP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 26.
๐ Previous Updates (v1.1.38 โ July 2026)
July 10, 2026 โ Page Agent Addon, Pro SPA v2 Parity, User Memory Toggle, Tool Enhancements, Workflow Improvements ๐ค๐ฌ๐ค๐๐
โ Page Agent Addon v0.1.0. New addon at
addons/page-agent/โ AI-powered browser page control copilot powered by Alibaba Page Agent (MIT). Gives any WordPress page its own AI agent that can click, type, and navigate via natural language. Runs entirely client-side with no headless browser, Python, or Chrome extension required. Includes shortcode[mcp_ai_page_agent], Elementor widget, REST endpoints, MCP tool bridge, and admin settings page.โ Pro SPA v2 โ Major Parity & Polish. Voice pipeline, tasks drawer, workflow tracker, and file attachment upload to WordPress Media Library. Tool Shortcuts and Slash Commands drawers for quick tool access. Mobile hamburger sidebar toggle. Speech/audio button fixes using correct ToolsClient REST endpoint. Conversation title improvements and turn count display fix. Button and token NaN fixes. Model sync and auth bypass fixes. Assistant preloading in runtime config to fix sidebar loading.
โ Pro SPA v2 โ UI Polish. Autoscroll fixes (scroll-to-bottom on submit, streaming start, user-at-bottom guard, restored via direct scrollTop instead of scrollIntoView). Viewport height fixes via CSS height chain instead of
calc(100vh - Xpx).overflow:hiddenon height-chain ancestors.filemtime-based cache-busting across all SPA addons. Lint errors resolved in both chat-SPA and pro-SPA. Deduplicated model selector to prevent React duplicate-key warning. REST route registration fixed and production assets rebuilt.โ Per-User Chat Memory Preferences. Users can now toggle chat memory on/off from their WordPress user profile. Individual control over AI memory retention without affecting site-wide defaults. Settings page integration.
โ create_post / save_post Tool Enhancements. Markdown-to-HTML conversion via new
WP_MCP_AI_Tool_Markdown_Convertertrait โ auto-converts Markdown content to HTML when creating or updating posts. Smart taxonomy suggestions auto-detect relevant categories and tags. Block content corruption fix for non-post post types.โ Workflow Blueprint & Schedule Improvements. Existing-content awareness in Content Publisher and Keyword Pipeline blueprints. Blog schedule presets now check for duplicate content before publishing. Readable response generation for workflow schedule result delivery.
โ SPA Accessibility. Annotation pills made clickable with meaningful labels for screen readers.
โ Security. OWASP ZAP DAST medium findings triaged as false positives.
๐ฆ Versioning โ bumped to 1.1.38 across
mcp-ai-wpoos.php,WP_MCP_AI_VERSIONconstant (includes/bootstrap/constants.php),readme.txt,README.md,CHANGELOG.md,QUICK_REFERENCE.md,ROADMAP.md, andDOCUMENTATION_INDEX.md. Tool count: ~195 base + ~830+ Pro (~1,025+ total; live count viaWP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers. Addon count: 26.
๐ Previous Updates (v1.1.37 โ July 2026)
July 4โ8, 2026 โ JetEngine Meta Helper, Places Enrichment, RabbitMQ, Multi-Tenant DB, DSpark UI, Test Coverage, Docs Hub Broken Link Engine ๐งฉ๐๐๐ข๐๐งช๐
โ JetEngine Meta Helper (Universal). Unified REST exposure for all 25 Pro CPTs โ
show_in_restandregister_post_metaapplied across the board. ECA_eca_*and_student_*fields registered in the JetEngine meta registry. MCP routing and error reporting bugs fixed. Load-order fix ensures the helper is available before dependent toolkit inits.โ Places Toolkit Enrichment. Two new AI tools โ
enrich_place_coordinates(batch geocoding) andenrich_place_details(Google Places API enrichment). Social media and booking fields added to the Places CCT schema. CLI bin scripts for batch enrichment operations. HTTrack import hardened: redirect stub handling, coordinate parsing, parent-child linking, and CLI parameter validation.โ RabbitMQ Client & Queue Infrastructure. RabbitMQ client wired with queue manager and async tool interception. Queue storage migrated from WordPress options to custom database tables for scalability. Health endpoint for queue monitoring. Dedicated queue worker for background processing.
โ Multi-Tenant Database Isolation (Phase 0โ4 Complete). Phase 0 laid the foundation with database isolation primitives and connection routing. Phases 1โ4 delivered query scoping, schema isolation, cross-tenant safety guards, and admin controls โ the full isolation stack is now operational.
โ DSpark Admin UI & Speculative Orchestration. New admin page with settings, threshold configuration, efficiency dashboard, presets, and a hook system for extensibility. Speculative orchestration enhancements with configurable execution strategies.
โ Crocoblock Design System Addon (All 5 Phases). New standalone addon at
addons/crocoblock-ds/. Unified CSS custom properties, preset templates, and admin-controlled theming for JetEngine, JetSmartFilters, and JetFormBuilder. Registered in addon inventory and build pipeline.โ Test Coverage โ 329 Tools Across 28 Toolkits. 301 previously untested tools now covered by batch tests. 6 previously untested pro toolkits with full coverage. 22 toolkits covered across 7 batch test files. HTTP testing infrastructure for remote tool tests. Docker plugin seed service for integration test coverage. CRM, PM, DietPi, and Cloudways test suites hardened with recursive file search, dependency resolution, and graceful skipping for abstract/missing classes.
โ Docs Hub Broken Link Detection & Repair Engine. Automated broken link scanning with results table. One-click Accept fix buttons on the detail table. Suggestion engine regression fixed (was producing no suggestions).
โ SPA Annotation Pills โ Accessible. Clickable pills with meaningful labels for screen readers.
โ CI/CD Hardening. OWASP ZAP DAST security scanning integrated into the CI pipeline. PHP bumped from 8.1 to 8.2 across all CI workflows. QA Docker setup fixed (unnecessary chmod on bind-mounted script).
โ Webhook & Agentic-Loop Resilience. Proactive agentic-loop context compaction prevents context overflow during long-running agent sessions. Webhook Context Manager enhanced with industry best practices. Sliding window context loss fixed across all 11 webhook controllers.
max_history_messagessection default normalized to match base settings (8).โ Shopify Sync โ Catalog API & Minimal Mode. Catalog API sync support for product caching. Minimal sync mode (title, SKU, stock levels only) for fast updates. Price field added to minimal mode payload.
โ BME Chat History Context Strategy. RAG memory integration for chat history. Settings relocated to General โ Behavior subtab on the new dashboard.
โ Bug Fixes. Shopify Catalog API silent failures and result reporting. Recurring sync stuck at old interval with missing connection IDs. Sync log batching via deferred writes to avoid per-item DB timeouts. Webhook auto-reply broken by missing Webhook Context Manager require. Import-blueprints and remaining-pro-tools file discovery. Extended-cognition toolkit missing requires for trait and interface. Tool tests: static data providers, constructor mocks, slug overrides, WP_Error returns. js-yaml DoS vulnerability override. ESLint and WPCS compliance across test files and enrichment tools.
๐ฆ Versioning โ bumped to 1.1.37 across
mcp-ai-wpoos.php,WP_MCP_AI_VERSIONconstant (includes/bootstrap/constants.php),readme.txt,README.md,CHANGELOG.md,QUICK_REFERENCE.md,ROADMAP.md, andDOCUMENTATION_INDEX.md. Tool count: ~195 base + ~830+ Pro (~1,025+ total; live count viaWP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers.
๐ Previous Updates (v1.1.36 โ July 2026)
June 29 โ July 4, 2026 โ EZuite Inventory Sync, Ralph Loop Orchestration, JetBooking/JetAppointment, Moonshot/Z.AI Parity, 45+ Bug Fixes ๐ญ๐๐ ๐ง ๐
โ EZuite Inventory Sync Pro Toolkit. ERP-integrated inventory sync bridging EZuite ERP with WordPress/WooCommerce. Product pull, inventory query, item create/update, ERP settings, and CLI sync commands. Admin UI with connection selector, field mapping, and sync direction controls. Toolkit registered in Pro addon with auto-discovery.
โ Ralph Loop CCT Migration & Orchestration. Circuit breaker pattern with configurable failure thresholds prevents cascading failures during cross-environment operations. Execution logger with step-by-step tracking and error reporting. CCT migration tools for safe JetEngine data transfers. Orchestration tools for coordinating multi-step workflows.
โ JetBooking/JetAppointment Integration (8 Tools). Adapter layer for Crocoblock JetBooking and JetAppointment plugins. 8 new AI tools added to the Calendar Booking toolkit. 4 existing calendar tools enhanced with booking/appointment awareness. Full CRUD for appointments, bookings, and availability queries.
โ Moonshot AI (Kimi) & Z.AI (GLM) Provider Parity. Both providers upgraded to full DeepSeek-level chat client capabilities โ streaming, tool use, token tracking, and error handling. ZAI client service registered in DI container alongside
client.baseten. Class loader updated for new provider adapters. WPCS formatting auto-fixed across all provider client files. Provider count now 15 first-class.โ Unified Sync Log Manager. Per-item audit trail across EZuite, FlowHub, and Shopify sync toolkits. Sync history with timestamps, status codes, and detailed error tracking. Status dashboards on toolkit settings pages. WP-CLI integration for log querying and export.
โ Tool Presets Auto-Select & Chips Bar. Selected tools display as clickable chips below the tool selector with proper spacing. +N overflow toggle when too many chips are selected. Tool payload cap raised from 50 to 100 tools per assistant. Method-existence guard against tools lacking
get_definition().โ HTTrack Cache Support & Place-to-Service Bridge. HTML place import tool now supports HTTrack cache directories for proper mirror parsing. URL backfill for mirrors without
hts-cachedirectory. Place-to-Service bridge auto-creates bookable services during batch place import. Service sharing prevented when source URLs collide.โ FlowHub Per-Connection Overview. Remote Sites connection selector added to FlowHub config tab. Per-connection sync controls โ run sync for individual connections instead of all-at-once. Proxy support via
http_api_curlhook with connection-level proxy resolution.โ Generate Default Mapping + Read-Only Sync. One-click default mapping buttons for EZuite and FlowHub field mapping. Read-only sync direction option โ pull data without pushing changes back to source.
โ Web Search 429 Retry. Exponential backoff for rate-limited (HTTP 429) web search requests with configurable retry count and base delay.
โ wp_mcp_ai_log Global Helper. Centralized logging function available globally, defined in
includes/bootstrap/for availability before class autoloading.โ JetEngine CCT Support for Remote WP Connections. Remote WordPress connections can now query and manage JetEngine CCT records โ full CRUD support for remote CCTs via the
remote_wp_connectiontool.โ CCT Module API & CRUD Fixes (Cross-Toolkit). Replaced fragile
jet_engine()->cctshorthand with canonicalModule::instance()across EZuite, FlowHub, and Shopify CCT managers. Standardized CRUD usingFactory/ItemHandlerAPIs. Addedtable_exists()fallback tois_cct_available()for lazy-init environments. Fixedget_cct_modulefalse negatives when CCT module is active but not yet loaded.โ EZuite Sync Fixes. Missing return value with error diagnostics. API field mapping response key mismatch. Remote Sites connections not showing in toolkit settings (2 rounds). CCT auto-registration reading from wrong option key.
โ FlowHub Sync Fixes. Silent success with 0 records now reports actual counts and errors. Proxy settings now correctly persist in Remote Sites connections. API auth header names corrected. Null CCT module guarded. Dry-run mode uses modules API instead of fragile shorthand. Location ID made optional with primary fallback.
โ Shopify Sync Fixes. Catalog API-only connections blocked with clear error. CCT registration lifecycle uses explicit sanitize-update cycle. Meta fields populated in CCT registration. Column add_field routed through
module->managerinstead of rawjet_engine()->cct.โ CCT Infrastructure Fixes. Duplicate column errors prevented in
ensure_columnsacross all three toolkits.add_fieldAPI replaced with direct SQL ALTER TABLE. Nonexistentget_item_by_slug()replaced with DB query. JetEngine CCT field definitions synchronized when columns missing.โ SQLite Meta Cache Explosion Fix. Unbounded meta cache growth on SQLite-backed sites resolved.
โ masterminds/html5 Case Collision Fix. Class file collision on case-insensitive filesystems (Windows/macOS) resolved.
โ Base-Version Guard Fix. Guard no longer incorrectly blocks toolkit admin pages in base+pro mode.
โ HTTrack Import Robustness. URL resolution, redirect filtering, and type classification. File discovery bugs (SKIP_DOTS, isDot, substring skip-dir matching). Hex-encoded filename support. Non-GNU glob compatibility for subdirectory content. Improved mirror root detection.
โ Necessity Gate & Safety Profile Fixes. Request context crash guarded against missing
get_instance(). Safety profile trait autoload fixed โ required from interface.โ Auto-Select Compute Fix. O(n*m) timeout on assistant edit page resolved.
โ Tool Chip UI Fixes. PHP parse errors from unescaped double-quotes in inline JavaScript fixed.
โ Documentation. Comprehensive abilities registration plan (~1,000 tools as WordPress Abilities). Laravel-scale deployment architecture proposal with Graphify ecosystem cross-references. WP.org submission prep (readme, index.php, canonical envelopes, READMEs). Agent context sweep โ
AGENTS.md,CLAUDE.md,.context/pro-vs-base.mdupdated. CHANGELOG v1.1.36 section.โ Housekeeping. Stale build artifacts and toolkit-addons directory cleaned.
๐ฆ Versioning โ bumped to 1.1.36 across
mcp-ai-wpoos.php,WP_MCP_AI_VERSIONconstant (includes/bootstrap/constants.php),readme.txt,README.md,CHANGELOG.md,QUICK_REFERENCE.md,ROADMAP.md, andDOCUMENTATION_INDEX.md. Tool count: ~195 base + ~830+ Pro (~1,025+ total; live count viaWP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 15 first-class language-model providers (added Moonshot Kimi & Z.AI GLM at DeepSeek parity).
๐ Previous Updates (v1.1.35 โ June 2026)
June 27โ29, 2026 โ FlowHub + Shopify Sync Pro Toolkits, Necessity Gate Layer J, Local Voice STT, Remote Site Admin Blueprint, Bulk Import, Fixes ๐ช๐๐ก๏ธ๐๏ธ๐
โ FlowHub Inventory Sync Pro Toolkit (PR #5501). 6-tool cannabis dispensary management toolkit. FlowHub Products (
flowhub_products) โ query by location, category, brand, strain type. FlowHub Inventory (flowhub_inventory) โ real-time levels, room/zone filtering, low-stock detection. FlowHub Locations (flowhub_locations) โ address, contact, operational status. FlowHub Sync (flowhub_sync) โ scheduled sync with webhook support. FlowHub Analytics (flowhub_analytics) โ sales trends, top products, category performance. FlowHub Alert Manager โ configurable low-stock and compliance alerts. FlowHub Settings (flowhub_settings) โ API credentials, sync intervals, notifications. Connection resolver trait. Admin UI toggle on Features tab. Folder README ataddons/pro/includes/tools/flowhub/README.md.โ FlowHub P1+P2 Enhancements (PR #5502). P1: Proxy support via
http_api_curlhook for environments behind forward proxies. P2: CCT auto-registration โ inventory data stored in JetEngine tables. Connection auth fixes: API header names corrected; class-name collision withWP_MCP_AI_FlowHub_Clientresolved. API key decryption on credential update fixed (PR #5500).location_idmade optional โ defaults to primary location. Null guard againstjet_engine()->cctfor sites without JetEngine.โ Shopify Sync Pro Toolkit (PR #5502). 5-tool bi-directional e-commerce sync: Shopify Products (
shopify_sync_products) โ product sync with variant support. Shopify Orders (shopify_sync_orders) โ order import with fulfillment tracking. Shopify Inventory (shopify_sync_inventory) โ real-time stock sync. Shopify Analytics (shopify_sync_analytics) โ cross-platform reporting. Shopify Settings (shopify_sync_settings) โ API credential and sync config. Dashboard widget. Connection resolver trait. Admin UI toggle. Tool reference docs atdocs/tools/shopify-sync-toolkit.mdanddocs/tools/flowhub-toolkit.md. Folder README ataddons/pro/includes/tools/shopify-sync/README.md.โ Necessity Gate Layer J โ Irreversibility-Weighted Safety Profiles. Pre-execution safety layer (
WP_MCP_AI_Necessity_Gate) scores tool calls by irreversibility risk. Write operations (create/update/delete) assigned risk scores by resource type. Safety profile trait loaded from interface for clean autoload. Request context crash fix: guards againstWP_MCP_AI_Request_Contextlackingget_instance().โ Local Voice Embedded STT (PR #5498). Three pluggable browser-side speech-to-text backends: browser-native Web Speech API, Whisper.cpp (WASM), and Vosk (WASM). Offline-first โ STT engines run entirely in the browser with no server dependency. Auto-detection selects the best available backend based on browser capabilities.
โ Remote Site Administrator Blueprint. New 22-tool CRM-style blueprint
remote-site-administrator.jsonin Site Creator toolkit. Pre-configured withremote_wp_connection, full JetEngine suite (11 tools), JetFormBuilder (2), site admin (4 โinstall_and_activate_plugin,install_and_activate_theme,update_option,create_post/update_post/delete_post),woo_products,generic_rest_api. Comprehensive system prompt with discoveryโschemaโexecution workflow, tool reference, and 8 safety rules. Temperature 0.3,manage_optionscapability. Auto-discovered by Unified Blueprints page andimport_site_creator_blueprinttool.โ Places & Calendar Bulk Import Tools (PR #5509). Batch import tools for Places and Calendar Booking toolkits. Places bulk import: batch geocode and store location records. Calendar bulk import: batch create events, appointments, bookings.
โ CLI site-import Subcommand.
wp mcp-ai site-importโ multi-phase HTML mirror import for migrating static sites into WordPress. Handles page structure extraction, content mapping, and media sideloading.โ Voice Realtime Auto-Detect (PR #5508). WebRTC realtime voice auto-detection โ automatically selects WebRTC or WebSocket transport. Duplicate message fix prevents echoed messages. VAD threshold improvements for better voice activity detection.
โ Remote Connections Fixes (PR #5499). WordPress connection case handling normalized. FlowHub and Printful credential storage fixed โ credentials correctly encrypted at rest. Printful connection type added to Remote Sites connection types.
โ Token-Scoped Assistant Resolution (PR #5497). Token-scoped assistant now preferred over site default in resolver, ensuring bearer-token-authenticated requests use correct assistant config.
โ User ID Empty Fallback (PR #5495).
user_idresolution updated to useempty()instead ofisset()for context fallback, fixing zero/empty-string bypass.โ Local Credential Token Mapping (PR #5493). Local credential token user ID mapping corrected for consistent identity resolution.
โ Post Type Name Lengths (PR #5484). Post type names exceeding 20-char WordPress limit now truncated with validation warnings.
โ OpenAI Image Deprecation Cleanup (PRs #5489-#5491). Removed deprecated DALL-E models. Applied chat model fallback to
edit_image_via_responses_api. GPT-5.x chat models for image generation. Defaults andresponse_formathandling fixed.โ Documentation. Agent context sweep โ
AGENTS.md(v1.7),CLAUDE.md(v2.7),.context/pro-vs-base.mdupdated. CHANGELOG v1.1.35 section.โ Housekeeping. Stale 1.1.34 build zips removed (6 files).
๐ฆ Versioning โ bumped to 1.1.35 across
mcp-ai-wpoos.php,WP_MCP_AI_VERSIONconstant (includes/bootstrap/constants.php),readme.txt,README.md,CHANGELOG.md,QUICK_REFERENCE.md,ROADMAP.md, andDOCUMENTATION_INDEX.md. Tool count: ~195 base + ~810+ Pro (~1,005+ total; live count viaWP_MCP_AI_Tool_Registry::get_tools()is authoritative). Provider count: 13 first-class language-model providers (unchanged).
๐ Previous Updates (v1.1.33 โ June 2026)
June 20โ24, 2026 โ WP 7.0 Connectors Credential Integration, nvoos-graphify v1.0.0, Security Fixes ๐๐งฉ๐ก๏ธ๐
โ WP 7.0 Connectors Credential Integration (PR #5458).
Credential_Resolverintegrated into all 17 AI clientget_api_key()methods (Anthropic, Baseten, DeepSeek, DigitalOcean, Gemini, Gemini Live, Google Maps, Hugging Face, Kimi, LM Studio, NVIDIA, OpenAI, OpenAI Realtime, OpenRouter, plus 3 service classes). Fallback chain: WP 7.0 Connectors โ plugin settings โ environment variables โ PHP constants. Newget_key_source()/get_key_source_label()methods added toCredential_Resolver. Credential source badges and WP 7.0 Connectors hints rendered in admin settings UI (Settings โ Providers). All 13 provider API key field descriptions updated to mention alternative credential sources. Provider diagnostics now show a Key Source column indicating where each provider's API key originates. Settings health check counts credentials resolved via theCredential_Resolver. 17 Pro addon files updated to useCredential_Resolver::has_credentials()/get_api_key()for provider selection, OCR routing, vector store, embeddings, speech, and performance checks. All PHPCS-clean with zero new errors.โ nvoos-graphify v1.0.0 Release (PR #5456). Standalone nvoos-graphify plugin released at v1.0.0 โ Plugin Check compliant and ready for distribution. nvoos-graphify-ai plugin released at v1.0.0-dev. Fixed 8 output-escaping errors in
Section.phpviaprintf()withesc_attr(). Fixed critical->prepare()spread-operator bug inDb::listNodes()causing runtime fatals. Renamedvectorcolumn โembedding_vectorto avoid MariaDB/MySQL reserved-word conflict; bumped DB version. Fixed snake_caseโcamelCase method calls across tools (GetNode,GetNeighbors,QueryGraph,GraphStats), controllers (SyncRemoteSource, REST), and cross-plugin integrations (nvoos-graphify-ai). Guarded missing Webhook driver and fixed Crypto namespace. Addedmessagefield to Enricher stub for detectable false-success states. Updated Remote README to reflect stub reality (no drivers, no SSRF, no encryption). Documented actual REST access model:read+ guest token for reads,manage_optionsfor export/write.โ Security Dependencies (PR #5457). guzzlehttp/guzzle 7.10.0 โ 7.12.1 (CVE-2026-55568, CVE-2026-55767). guzzlehttp/psr7 2.11.0 โ 2.12.1 (CVE-2026-55766). guzzlehttp/promises 2.3.0 โ 2.5.0. undici npm override tightened from
>=7.28.0to>=8.5.0to match resolved version and prevent downgrades.โ npm Security (PR #5438). 29 npm security alerts resolved across 14 packages. undici: TLS bypass (CVE-2026-9697) and cache info disclosure (CVE-2026-9678) โ override applied to 11 addon lock files. http-proxy-middleware: CRLF injection (CVE-2026-55603) โ override
>=3.0.7. nodemailer: raw option bypass (GHSA-p6gq-j5cr-w38f) โ bumped^8.0.9โ^9.0.1. webpack-dev-server: HMR interception (CVE-2026-9595) โ override>=5.2.5. dompurify: ALLOWED_ATTR pollution (GHSA-cmwh-pvxp-8882) โ bumped^3.4.9โ^3.4.11. Fixed critical duplicateoverrideskey in rootpackage.jsonthat silently discarded all 39 security overrides.โ Bug Fix โ WP All Import/Export Pro Tools (commit
0de3cdf). Fourrequire_oncepaths in the Pro bootstrap map (addons/pro/mcp-ai-wpoos-pro.php) were missing-pro-in the filenames, referencingclass-wp-mcp-ai-tool-*.phpinstead of the actualclass-wp-mcp-ai-pro-tool-*.phpfiles on disk, causing fatal errors when those tools loaded.โ Bug Fix โ Tool Status Label Loader (commit
749ffce). Replaced fragile@file_get_contents()with explicitset_error_handler('__return_true')/restore_error_handler()in both copies ofload_tool_status_labels()(includes/class-wp-mcp-ai-tool-registry.phpandincludes/admin/sections/class-wp-mcp-ai-section-tools.php). The@operator does not reliably suppress warnings across all PHP 8 configurations (e.g. xdebug.scream, custom error handlers), and leaked warnings corrupt MCP JSON-RPC HTTP responses.โ Dependency Updates. 15 Dependabot version bumps across the monorepo: Composer (guzzlehttp/psr7 2.11.0โ2.12.1). npm/Pro (stripe 14.25.0โ22.2.3, csv-parse 5.6.0โ7.0.0, p-queue 8.1.1โ9.3.0, @puppeteer/browsers upgrade). npm/SaaS Controller (@wordpress/eslint-plugin 25.2.0โ25.4.1, zod 3.xโ4.4.3, @tanstack/react-query upgrade, wrangler upgrade). npm/Cloud Worker (stripe upgrade, vitest 2.xโ4.1.9, @cloudflare/workers-types upgrade). npm/Docs Hub (@typescript-eslint 8.xโ8.62.0, @types/nodeโ26.0.0). GitHub Actions (codecov/codecov-action 4โ7, softprops/action-gh-release 2โ3).
โ Housekeeping. Stale 1.1.31 build zips removed (PR #5437). Stale 1.1.32 build zips removed (6 files). SPA addon ZIPs rebuilt with updated security overrides and dependency bumps. nvoos-graphify standalone ZIP built at v1.0.0. nvoos-graphify-ai ZIP built at v1.0.0-dev.
๐ฆ Versioning โ bumped to 1.1.33 across
mcp-ai-wpoos.php,WP_MCP_AI_VERSIONconstant (includes/bootstrap/constants.php),readme.txt,README.md, andCHANGELOG.md. Provider count: 13 first-class language-model providers (unchanged). Tool count: ~195 base + ~795 Pro (~990 total; live count viaWP_MCP_AI_Tool_Registry::get_tools()is authoritative).โ MCP Initialize: Assistant-Scoped Instructions & Model Preferences (PR #5462). Both the base
/mcp-ai/v1/mcpendpoint and all 29 Pro toolkit MCP servers now carry the assistant's system prompt, professional role context, model preferences (modelPreferencesโ supported by Zed, Claude Desktop, Cursor), and knowledge base references in theinitializehandshake instead of a generic WordPress site description.serverInfo.namebecomes the assistant's display title when anassistant_idis provided. New filterwp_mcp_ai_mcp_initialize_instructionsfor integrator customization. Zero breaking changes โ behavior is identical when noassistant_idis passed. Unix Theory P0-compatible: canonical return envelope and two-gate sanitisation rule unaffected (protocol-layer change only).
June 17โ19, 2026 โ Content Format Templates, Result Delivery Pipeline, Featured Images, Provider Timeout Fixes ๐๐ฌโฑ๏ธ๐ง
โ Content Format Templates & Featured Image Generation (PR #5433). Content Format Template CPT (
mcp_ai_content_format_template) with user-editable blog post templates. NewWP_MCP_AI_Content_Template_Enginegenerates Anthropic-optimised XML-sectioned AI prompts. NewWP_MCP_AI_Featured_Image_Servicewith 3-provider fallback (OpenAI DALL-E โ Google Gemini โ Cloudflare AI) and 5 image styles. Image Generation Provider dropdown on the CPT metabox. Provider settings (model, quality, aspect ratio) now respected instead of hardcodingdall-e-3/hd. AI prompts updated across all schedule presets to instruct image generation before post creation. 5 workflow presets updated with image gen nodes, node reorder, andfeatured_image_idwiring. Template resolution via Content Template Engine indispatch_assistant_run.resolve_node_template_variablesfor cross-node variable passthrough. 5 default templates seeded on activation.โ Result Delivery Pipeline (PR #5425). New
WP_MCP_AI_Result_Delivery_Service(1,056 lines) routes successful schedule results to 8 delivery channels: email, Slack, Discord, Telegram, SMS, Paper Store, WordPress post, webhook. Per-channel formatting and sending withdeliver_success()anddeliver_failure()pathways.result_deliveryschema added to schedule CRUD. Result Delivery section in schedule edit modal UI. Delivery status appended to run history and result envelopes. Pre-configured Paper Store delivery for 8 research/audit presets. Both success and failure paths now deliver โ previously only failures were surfaced.โ ECA Document Generation (PR #5423). ECA Consolidate & Add page with document generation tools. PHPCS alignment fixes across ECA admin pages.
โ Duplicate Posts & Provider Image Fixes (PR #5434). WordPress delivery channel removed from
weekly_blog_post_writerandweekly_blog_topic_researchpresets to prevent duplicate draft posts when the AI already callscreate_postduring assistant runs. Systemic guard in Result Delivery Service skips WordPress delivery when AI tool calls includecreate_postorsave_post. Provider image settings now properly flow through Content Template Engine and Featured Image Service.โ 6 Provider Clients Now Respect Timeout (PR #5431). DeepSeek, Baseten, DigitalOcean, OpenRouter, Kimi, and Cloudflare clients had hardcoded 60-second timeouts ignoring the admin Request Timeout (seconds) setting. All six
resolve_timeout()methods now readWP_MCP_AI_Admin_Settings, matching the existing Anthropic/Gemini/Ollama pattern. Kimi retains its provider-specifickimi_timeoutoverride.โ Schedule Trigger Stability (PRs #5429, #5430). Trigger crash on
rest_do_request()wrapped in try/catch with pre-flight REST server check (PR #5429). User context restored and filters cleaned up in all error paths.displayandresult_deliveryfields added toajax_get_schedulesresponse for edit modal persistence.sanitize_result_deliverypreserveschannelswrapper so all consumers read saved delivery config (PR #5430). Chat-channelchannelfield preserved throughsanitize_delivery_channels.ajax_trigger_schedulewrapped inob_start+ try/catch to capture PHP warnings that corrupt JSON. Trigger debug output logged to browser console whenWP_DEBUGis on.โ Paper Store Delete Confirmation Fix (PR #5432). Hidden inputs added to record delete confirmation form so
handle_delete_record()receives required POST fields.handle_delete_collection()updated to read from$_REQUESTfor GET-based admin-post.php links.โ ECA Settings Menu & Attachment Fix (PR #5421). ECA settings menu placement corrected. Attachment upload crash in ECA admin pages resolved.
โ npm CI & Jest Resilience (PR #5428).
@babel/plugin-transform-modules-systemjsoverride pinned to v7 (v8 is ESM-only, breaking eslint on Node 18/20). Rootpackage-lock.jsonregenerated with override applied.jest.config.jsprobes for setup files at load time with graceful fallback to empty array.jest.setup.jsat repo root.|| exit 0ontest:coveragefor CI. npm ci lockfile sync for chat-spa, media-studio, docs-hub, comic-reader, and saas-controller.โ Dependency Updates. 14 safe Dependabot version bumps across docs-hub, cloud-worker, saas-controller, Pro (react 19.2.6โ19.2.7, vitest 4.1.5โ4.1.9, stripe, workers-types, eslint 8.59.2โ8.61.1, php-stubs 6.9.1โ7.0.0, mailparser 3.7.1โ3.9.9, validator 13.12.0โ13.15.35). 8 npm audit CVEs fixed: nodemailer, tar, tar-fs. Security overrides added to 8 addon package.json files.
phpoffice/phpspreadsheetlock synced 5.7.0โ5.8.0.๐ฆ Versioning โ bumped to 1.1.32 across
mcp-ai-wpoos.php,WP_MCP_AI_VERSIONconstant (includes/bootstrap/constants.php),readme.txt,README.md, andCHANGELOG.md. Provider count: 13 first-class language-model providers (unchanged). Tool count: ~195 base + ~795 Pro (~990 total; live count viaWP_MCP_AI_Tool_Registry::get_tools()is authoritative).
June 16โ17, 2026 โ Media Command Center, Pro SPA v2, Workflow Presets, npm CVEs, Gemini 3.1 Flash ๐ฌ๐ฌ๐งฐ๐๐จ
โ Media Command Center (PR #5402). Top-level "NV Media" admin menu with command center for managing media workflows. Template and preset management. PHPCS cleanup and
implode()WP_Error crash fix in the templates tab.โ Pro SPA v2 Migration & Rich Rendering (PRs #5401, #5412, #5414). Pro SPA v2 ported to feature parity with chat-spa and old pro-spa. Rich markdown rendering for assistant responses. Per-assistant scoping dropdown and agent selector. Conversations set as primary view; threads marked read-only after archival. CSS class-name mismatches fixed, causing previously unstyled UI to render correctly. Cache-bust version bump and admin layout fit within WordPress chrome (PR #5416). Bumped to v2.0.1.
โ 34 Missing Workflow Preset Tools (PR #5418). All missing workflow presets implemented across 10 toolkits (AI Tool Builder, Analytics, Architect Agent, Architectural Design, Calendar Booking, CRM, Document Generation, DJ Management, Social Media, Video Production). Orphaned media tools created and Upwork tool availability fixed. Full PHPCS compliance and comprehensive test suite validating all 36 new tools (class existence, interface implementation, slug resolution, metadata, capability flags).
โ npm Audit CVE Fixes (PR #5419). 12 CVEs resolved across the dependency tree: vite (CVE-2026-53571 server.fs.deny bypass), launch-editor (CVE-2026-53632 NTLMv2 disclosure), markdown-it (CVE-2026-48988 smartquotes DoS), ws (memory exhaustion), js-yaml (quadratic DoS), form-data (CRLF injection), hono (path traversal, CORS, Set-Cookie), dompurify (XSS sanitization bypasses), @babel/core (arbitrary file read), @opentelemetry/core (unbounded memory), joi (RangeError DoS). ajv bump reverted to restore ESLint 8 compatibility. Root npm audit: 51โ0 vulnerabilities.
โ Gemini 3.1 Flash Image Default (PR #5404). Default Gemini image generation model upgraded to
gemini-3.1-flash-image.โ Media Toolkit Blueprints & Scheduler Presets (PRs #5398, #5411). Blueprints and scheduler presets added to the media toolkit. Media Toolkit sync integrated into the Data Management page. Private
get_media_presets()visibility fixed to prevent fatal error when called externally.โ OpenAI/DeepSeek stream_options (PR #5400).
stream_optionspayload added to OpenAI and DeepSeek streaming API calls, enabling proper usage-tracking inclusion during streaming responses.โ Tool Result Cost Calculation (PR #5395). Tool result costs now computed from token counts when not explicitly provided by the provider, ensuring accurate cost attribution in agentic loops.
โ Agentic-Loop Cost Tracking (PR #5394). Missing provider pricing entries added across the cost-tracking layer, fixing under-reporting in multi-turn agentic workflows.
โ Vite CVE Fixes (PR #5403). vite pinned to ^8.0.16 in devDeps to resolve CVE-2026-53571 (server.fs.deny bypass) and CVE-2026-53632 (NTLMv2 disclosure via launch-editor middleware). Pro SPA v2 production assets built and dist output un-gitignored.
โ 1,658 PHPCS Lint Fixes (PR #5397). Full lint pass across base plugin and Pro addon (44 toolkits). Short ternaries converted to full, count() moved out of loops, docblock capitalisation normalized, require_once paths corrected for renamed optimization and tool files.
โ CI Disk Space Cleanup (PR #5417).
Free disk spacestep added to all build workflows to prevent runner disk exhaustion during large ZIP assembly.โ Data Integrity Fixes. PII pseudonymisation logic restored after being lost during a merge conflict resolution (PR #5398). CPT data store post type mismatch for CRM entities resolved (PR #5396).
June 12โ15, 2026 โ Chat SPA Phase 8, PM Toolkit AโD, CRM Duplicates & Hygiene, DietPi Toolkit, LibreChat Addon, Context Windows, WP 7.0 Bridge ๐ชฒ๐ฌ๐๐ง๐ก๏ธ
โ Chat SPA Phase 8 โ Message Actions & Content Enrichment (PRs #5381, #5383, #5390). Conversations sidebar with assistant scoping in the Pro Chat SPA. Auto-create thread when posting to a non-existent thread. Message action cards on every assistant bubble: edit, delete, regenerate, copy, and content enrichment. Pro SPA chat routed through chat-client endpoint; threads marked read-only after archival.
โ Project Management Toolkit Enhancement Phase AโD (PR #5370). Shared
WP_MCP_AI_PM_Enginepowering the new Command Center dashboard with real-time task visibility, status filters, and bulk actions. Work Ingestion panel on the tasks tab for importing external tasks. 28 new AI tools spanning task management, resource allocation, timeline generation, and reporting.โ CRM Toolkit โ Duplicates, Email Hygiene & Analytics (PRs #5362, #5367, #5368). Duplicate detection engine with safe one-click merge and bulk merge from the new Duplicates tab. Email hygiene module: classify domains by reputation, manage exclusion/priority lists, and auto-prune. Top Customers and Top Clients analytics tools with dedicated Command Center tabs. Merged status filter and column on leads admin list. Inline tag editing and email priority/exclude actions. Repair CRM data tool fixing broken dates, generic titles, and impersonal sender names. Refresh All Sources button on Support tab. LinkedIn & Upwork external sourcing with LinkedIn as a Remote Sites OAuth 2.0 connection type.
โ DietPi Pro Toolkit Phases 0โ3 (PRs #5346, #5348, #5350). Foundations: CPT/CCT scaffolding, admin settings page, 19 core tools for system monitoring, package management, and service control. Phase 2: backup, update, storage, and dashboard tools. Phase 3: provisioning automation, infrastructure blueprints, and SSH proxy. Registered as an MCP server with Feature subtab toggle.
โ LibreChat Addon (PR #5336). New
addons/librechat/addon with code interpreter, speech-to-text/text-to-speech services, and web search reranker. Added to SPA build workflow and addon ZIP build pipeline.โ Layer I Guardrails โ Stay-on-Target Jailbreak Prevention (PRs #5340, #5344). Harness Layer I intercepts prompt-injection and role-change attacks. Activated per-assistant via the LLM Harness metabox.
โ Context Window Management โ All 13 Providers (PRs #5335, #5348, #5352). Pre-flight context-window validation added to every AI provider client (OpenAI, Anthropic, Gemini, DeepSeek, OpenRouter, Baseten, Kimi, DigitalOcean, NVIDIA, Cloudflare, Hugging Face, LM Studio, Ollama). Shared
validate_context_window()helper in the language model router. tiktoken integration for accurate token counting with estimator metabox on the Assistant editor. Token-budget tool capping โ tools exceeding remaining budget are auto-excluded. Chat parity drift detection workflow. Model limits synced with June 2026 canonical catalog.โ WP 7.0 Connectors API Bridge (PR #5387). Bridge for provider credentials enabling forward-compatibility with the WordPress 7.0 Connectors API. Classes load unconditionally to prevent fatal errors on WP < 7.0.
โ Chat Transcript & Agent Memory Retention (PRs #5356, #5357).
WP_MCP_AI_Transcript_Retentionโ configurable retention policies and automatic cleanup cron.WP_MCP_AI_Memory_Retentionโ agent memory lifecycle management with pruning and retention windows.โ Pro Toolkit Optimizations Phase 1โ3 (PRs #5355, #5356, #5357). Phase 1: Chat Channels and Social Media toolkits. Phase 2: Healthcare, Ecommerce, Calendar, and Orchestration. Phase 3: Document Generation and QMS. All classes wired into their toolkit init files with 767-line PHPUnit test suite.
โ OAuth & API Connection Management (PR #5351). Disconnect buttons for OAuth and API connections. Auto-clear OAuth tokens when provider credentials change on save.
โ SPA Reliability Sweep (PRs #5371โ#5379). Register thread REST endpoints (fixes
createThreadcrash). Fix SPA router context error. FixcreateThreadevent serialization crash. Register POST/threads/{id}/messagesendpoint. Pass model and profile tocreateThread. Fix SPA bootstrap tools, turn count, and REST route. Fix SPA enqueue paths and PM blueprints. Restore Zed-inspired SPA after accidental revert. Build SPA bundle and fix import paths.โ Core & Provider Fixes. 12 test suites fixed and SPL autoloader ordering corrected (#5392). Toolkit MCP tools returning empty
inputSchemafor image tools (#5391). OOS engine fatal error from undefinedsendRequest(#5389). Agentic loop tool result persistence across all providers (#5354). OpenAI real-time SSE streaming (#5327). Bridge credential resolver on WP < 7.0 (#5388). Stale provider validation lists rejecting DeepSeek (#5323). Schedule preset data mismatches (#5329).โ CRM & Data Fixes. CRM configured sources count showing 0 for valid Gmail connections (#5386). Slider/range fields not rendering (#5361). 3 CPT slugs exceeding 20-character limit (#5361). Support ticket CPT rename
mcp_ai_support_ticketโmcp_ai_ticket(#5360). Memory tools capability flags (#5364). Extended Cognition review issues (#5363). Playbook orphans and sync timeouts (#5322, #5325).โ Addon Fixes. Docs Hub: async rebuild stalls, browse critical error, broken Intuit privacy link (#5359). Cloudways Dashboard: removed
Requires Pluginsheader (#5353); base-active check in_is_ready()(#5385). Pro Integrations subtab overwriting redirect (#5347). Performance monitor: buttons, reports, test execution restored (#5366). DietPi Toolkit PHPCS and PHPCompat fixes (#5346).โ Security. guzzlehttp/psr7 pinned to ^2.10.2 for CVE-2026-49214 (#5352). esbuild pinned to ^0.28.1; integrity check vulnerability in Pro addon (#5382). shell-quote bumped to >=1.8.4 for CVE-2026-9277 (#5330). vitest/vite/esbuild alerts in schedule-anything-spa (#5338).
โ Infrastructure.
redirect_canonicalno longer breaks well-known endpoints (#5349).tool-status.txtreads guarded against missing files (#5348). WPCS lint in section-tools and tool-registry (#5348). ESLintno-varin performance-admin.js (#5366). PHPCS in CRM analytics (#5320). Chat parity workflow YAML and permissions fix (#5336).โ Blueprint & Doc Updates. 46 healthcare-style blueprints converted to CRM-style format (#5373). All legacy flat-format blueprints upgraded to canonical (#5372). v1.1.29 comprehensive documentation refresh across all surfaces (#5365). 66 proposal statuses audited (#5335). README updated with PM toolkit and repository map (#5370). 75 PHPCS violations auto-fixed in Pro bootstrap (#5321).
๐ฆ Versioning โ bumped to 1.1.31 across
mcp-ai-wpoos.php,WP_MCP_AI_VERSIONconstant (includes/bootstrap/constants.php),readme.txt,README.md, andCHANGELOG.md. Provider count: 13 first-class language-model providers (unchanged). Tool count: ~195 base + ~795 Pro (~990 total; live count viaWP_MCP_AI_Tool_Registry::get_tools()is authoritative).
๐ Previous Updates (v1.1.32 โ June 2026)
June 7โ11, 2026 โ Bug-Fix & Stabilisation Sweep ๐ชฒ๐งโก
โ Chat Bubble Assistant Dropdown (PR #5333). Fixed settings UX:
chat_bubble_assistant_idfield on the Chat Bubble settings page (wp-admin/admin.php?page=wp-mcp-ai-dashboard&tab=general&subtab=chat_bubble) changed from a plain<input type="number">to a proper<select>dropdown populated with all published assistants. Addedget_assistant_options()helper method toWP_MCP_AI_Section_Chat_Clientmatching the pattern used bydefault_assistantin General โ Core Settings. Users can now select assistants by name instead of manually typing numeric IDs.โ Context-Window Pre-Flight Validation โ All 13 Providers (PR #5328). Added pre-flight context-window validation to all AI provider clients: OpenAI, Anthropic, Gemini, DeepSeek, OpenRouter, Baseten, Kimi, DigitalOcean, NVIDIA NIM, Cloudflare, Hugging Face, LM Studio, and Ollama. Shared
validate_context_window()helper method inWP_MCP_AI_AI_Client_Base. Integratedtiktokenfor accurate token counting with estimator metabox on the Assistant editor. Token-budget tool capping prevents exceeding model limits. Context-window management documentation atdocs/developer/architecture/context-window-management.md.โ OpenAI SSE Streaming Fix (PR #5327). Fixed
stream_optionspayload flag that prevented OpenAI real-time SSE streaming from triggering. Theinclude_usageflag was incorrectly nested, causing the OpenAI API to ignore the streaming request and return a non-streamed response.โ Schedule Preset Data Mismatches (PR #5329). Fixed schedule preset data mismatches where presets would lose configuration data after save. Improved error logging for preset operations with structured log contexts.
โ Playbook Orphan Cleanup & Batching (PRs #5322, #5325). Fixed orphan playbook accumulation where deleted parent records left unreachable children. Added JetEngine validation before deletion to prevent data corruption. Fixed sync timeouts for large playbook sets by implementing batch processing with configurable chunk sizes.
playbook_delete_batch_timeoutnow uses iterative deletion instead of single-query operations.โ Stale Provider Validation Lists (PR #5323). Fixed provider validation lists in multiple locations that rejected DeepSeek and newer providers. Updated
WP_MCP_AI_Section_General::validate()andWP_MCP_AI_REST_Chat_Controllerprovider checks to use dynamic provider discovery viaWP_MCP_AI_Admin_Settings::get_available_providers()instead of hardcoded arrays. Also fixed default provider validation in CRM settings and Pro REST controllers.โ CRM Activity Titles, Due Dates & Block API v3 (PR #5320). Fixed CRM activity post titles not displaying correctly when created via AI tools. Fixed due date calculations for recurring activities. Migrated CRM admin blocks to WordPress Block API v3 (
apiVersion: 3) for compatibility with WP 6.9+.โ OpenAI-Compatible Client โ DeepSeek Parity (PR #5315). Enhanced all OpenAI-compatible chat clients (OpenRouter, Baseten, Kimi, DigitalOcean, NVIDIA NIM) to parity with the DeepSeek client: added
max_completion_tokenssupport, temperature normalisation,top_phandling, and properstopsequence forwarding.โ Voice & Embedded LLM Missing Assets (PR #5319). Added missing
.min.jsasset files for voice recording/transcription scripts and embedded LLM worker scripts. These files were referenced bywp_register_script()but missing from the build output, causing 404 errors on sites using minified assets.โ Chat Config messagesEndpoint & Tool Count Guard (PR #5318). Fixed chat config
messagesEndpointpointing to the wrong REST route in certain configurations. Added a tool count guard that returns a clear error message when an assistant has more tools configured than the provider's limit, preventing silent failures.โ Chat Debug Console Fixes (PRs #5316, #5317). Fixed
chatDebugModeusing loose equality (==instead of===) so PHP's string'1'is accepted alongside JavaScript's booleantrue. Fixed legacy chat debug console not displaying when enabled via admin settings โ the debug panel container was hidden by a CSS rule that only targeted the new SPA debug view.โ OOS Bridge, Embedding Fatal & SSE Headers (PR #5313). Fixed OOS bridge initialization failing when the core framework was loaded before WordPress user context was available. Fixed embedding service fatal error when API key was not configured โ now returns a graceful
WP_Error. Fixed SSE header warnings in PHP 8.1+ caused byheader_remove()being called after output started.โ Memory Cookie-Check Nonce Fix (PR #5312). Fixed "Cookie check failed" error on the admin Test Assistant memory drawer. The memory REST controller was generating a nonce on
init(before the user session was available), producing an invalid nonce for authenticated users. Nonce generation moved to thewphook.โ Chat Transcript Tests โ 4% to 87% Pass Rate (PR #5310). Fixed chat transcript REST controller tests. Root causes: test factories not creating posts with the correct
post_type, missingWP_REST_Serverinitialization, session key normalisation mismatches, and permission callback assertions testing the wrong user role. Pass rate improved from ~4% (3/80) to 87% (70/80).โ Graphify Related Content Leak (PR #5291). Fixed graphify related content leaking to wrong page sections โ content isolation tightened so graph nodes only render within their designated container element.
โ Model Limits โ June 2026 Canonical Catalog (PR #5331). Synced model limits (max tokens, max output tokens, rate limits) with the June 2026 canonical catalog across all providers.
โ Security โ shell-quote CVE-2026-9277 (PR #5330). Bumped
shell-quoteto >=1.8.4 via npm overrides to fix CVE-2026-9277 (command injection via insufficient escaping).๐ฆ Versioning โ bumped to 1.1.29 across
mcp-ai-wpoos.php,WP_MCP_AI_VERSIONconstant (includes/bootstrap/constants.php),package.json,readme.txtStable tag,README.md, anddocs/DOCUMENTATION_INDEX.md. Provider count: 14 first-class language-model providers (OpenAI, Gemini, Anthropic, DeepSeek, OpenRouter, Baseten, Kimi, DigitalOcean, NVIDIA NIM, Cloudflare, Hugging Face, LM Studio, Ollama, Flowhub). Tool count: ~195 base + ~795 Pro (~990 total; live count viaWP_MCP_AI_Tool_Registry::get_tools()is authoritative).
๐ Previous Releases
For full details on all releases, see CHANGELOG.md.
Version | Date | Highlights |
v1.1.44 | Aug 2026 | CCT stability (4 fixes: mutex lock, FlowHub duplicate, base-plugin fatal w/out lib/core, Veo async context), API key resolution (Gemini video + Veo fallback), Proposal 016 security & architecture hardening (all waves, 277 autoload optimizations, phpcs sweep), Proposal 017 polling/queue/load-balancing hardening (12 weaknesses), Deferred security items #5755 (post meta, term escaping, REST field filtering), npm security (undici >=8.10.0, fast-uri >=3.1.4, ip-address >=10.4.0 across 11 pkg), Docs: FOR_REVIEWERS v1.1.43 update, 16 broken links fixed, Graphify ecosystem audit |
v1.1.43 | Aug 2026 | MCP 2026-07-28 stateless core upgrade, Security v1.1.43 hardening (SSRF/CSRF/SQL/XSS/info-disclosure across 16 files), OKF v0.2 trust-signal support, ICP System (Pro CRM Phase G, 7-dimension scoring), Pro Module Registry (PSR-4, 625-line monolithic init decomposed), Hexagonal architecture purity (PlatformFlushInterface), 7 playbook/profession sync fixes, Phase 3 operational security hardening, WPCS 3.4.1 (CVE-2026-45293) |
v1.1.42 | Jul 2026 | Security Infrastructure (7 classes, 21 posture signals A-F), Framework-Agnostic Core (lib/core/, 32 contracts, 21 adapters), Status Page & Incident Communication (Pro), 21 Agent Skills + 6 BMAD Agents, Algorave addon (9 tools), Security Hardening (12 fixes, 13 unit tests) |
v1.1.38 | Jul 2026 | Page Agent addon v0.1.0 (AI browser page control copilot), Pro SPA v2 major parity & polish (voice pipeline, tasks drawer, workflow tracker, file attachments, tool shortcuts, slash commands, mobile hamburger, autoscroll/viewport fixes, cache-busting, assistant preloading), Per-user chat memory toggle, create_post/save_post Markdown-to-HTML + taxonomy suggestions, Workflow blueprint existing-content awareness, SPA accessibility: annotation pills, ZAP medium findings triaged |
v1.1.37 | Jul 2026 | JetEngine Meta Helper universal (25 CPTs, REST, ECA fields), Places enrichment tools, RabbitMQ + queue infrastructure (custom DB tables, health endpoint, worker), Multi-tenant DB isolation Phase 0โ4, DSpark admin UI + speculative orchestration, Crocoblock Design System addon (5 phases), Test coverage: 329 tools across 28 toolkits, Docs Hub broken link engine, OWASP ZAP DAST, 30+ bug fixes |
v1.1.36 | Jul 2026 | EZuite Inventory Sync Pro Toolkit, Ralph Loop CCT migration + circuit breaker, JetBooking/JetAppointment (8 tools), Moonshot/Z.AI provider parity (15 total), Unified Sync Log Manager, Tool Presets Auto-Select + Chips Bar, HTTrack Cache + Place-to-Service Bridge, Generate Default Mapping + read-only sync, 45+ bug fixes |
v1.1.35 | Jun 2026 | FlowHub Inventory Sync Pro Toolkit (6 tools), Shopify Sync Pro Toolkit (5 tools), Necessity Gate Layer J (irreversibility-weighted safety), Local Voice Embedded STT (3 backends, offline-first), Remote Site Administrator blueprint (22 tools), Places & Calendar bulk import, CLI site-import subcommand, voice realtime auto-detect, 7 bug fixes |
v1.1.34 | Jun 2026 | GPT-Realtime-2 voice models with WebRTC + Translate/Whisper + reasoning, multi-channel result delivery UI (11 channels, up from 4), pro scheduler AI/workflow delivery, Graphify ecosystem: remote drivers, WP 7.0 Connectors, wp.org compliance, 3 reasoning-tool fatal bugs fixed, CRM deal import + multi-source auto-import, Upwork/LinkedIn mode toggle, Docs Hub REST + settings sync fixes, http-proxy-middleware CVE, Gemini cache fix, GPT image routing fix, FastAPI porting plan |
v1.1.33 | Jun 2026 | WP 7.0 Connectors credential integration across all 17 AI clients with source badges, nvoos-graphify v1.0.0 release (Plugin Check compliant), 3 guzzlehttp CVEs + undici override, 29 npm alerts across 14 packages, 2 bug fixes (Pro tool paths, JSON-RPC warning leak), 15 dependabot bumps |
v1.1.32 | Jun 2026 | Content Format Templates + Featured Image Service (3-provider fallback), Result Delivery Pipeline (8 channels), ECA document generation, duplicate posts fix, 6 provider clients timeout fix, schedule trigger stability, Paper Store delete fix, ECA settings/attachment fix, npm CI & Jest resilience, 14 dependabot bumps + 8 npm audit CVEs |
v1.1.31 | Jun 2026 | Media Command Center, Pro SPA v2 (rich rendering, assistant scoping, agent selector, v2.0.1), 34 workflow preset tools, npm audit CVEs (12 resolved), Gemini 3.1 flash image default, Media toolkit blueprints & presets, stream_options, agentic-loop cost tracking, Vite CVEs, 1,658 PHPCS lint fixes, CI disk space, data integrity fixes |
v1.1.30 | Jun 2026 | Chat SPA Phase 8, PM Toolkit AโD, CRM duplicates/hygiene/analytics, DietPi Pro Toolkit, LibreChat Addon, Layer I Guardrails, Context Window Management, WP 7.0 Bridge, Pro Toolkit Optimizations, OAuth disconnect, 30+ fixes |
v1.1.28 | Jun 2026 | CRM Phase C complete (IMAP, SMS, WhatsApp ingestion), Customer CPT + 360 dashboard, Support Ticket module (10 AI tools + SLA), QKV Attention Routing, Funiq Bridge addon, NVOOS Graphify ecosystem (3 standalone plugins), NV Platform AI addon, automated demo video pipeline, TF-IDF + BM25 relevance search |
v1.1.27 | Jun 2026 | Real-time SSE streaming for all OpenAI-compatible providers, 35 new OOS core tools migrated, JFB submission tools โ 8 fixes, Extended Cognition vision recognition, DeepSeek agentic tool handling, 9 HIGH-severity security findings fixed, 95% PHPUnit failures resolved |
v1.1.26 | Jun 2026 | Cross-Platform Extraction Engine Phases 0โ2, Site-Builder Node-Graph Pipeline, SPA a11y hardening (WCAG 2.1 AA), 108 admin screenshots, docs reorganized into 12 directories |
v1.1.25 | May 2026 | Unified Blueprint System (55 blueprints across 25 toolkits), Cloudways Pro Toolkit (60 tools), CRM Toolkit Phases AโE (70+ tools), Chat UI 7-feature enhancement, Unix-theory Phase 4โ5 |
v1.1.24 | May 2026 | Chat SPA fixes, Unix Theory P0/P1 refinement, CVE patches (tmp, symfony/cache), Paper Store admin CRUD, folder README convention |
v1.1.23 | May 2026 | Zed-inspired SPA architecture, Antigravity Interactions API rewrite, TypeScript upgrade, Comic Reader & Media Studio v0.3.0 |
v1.1.22 | May 2026 | Baseten provider (11th), CoSAI secure-by-design agentic system, Continual Harness P5, SaaS Controller P2/P4, npm VAD/Chat-Bubble/Memory-UI packages |
v1.1.21 | May 2026 | WP.org compliance complete (50/50 findings), canonical return envelope enforced, semantic compression, AI prompt caching layer |
v1.1.20 | May 2026 | Memory Layer 2026 Phase 7 โ chat memory drawer UI complete |
v1.1.19 | May 2026 | Kimi provider (10th), ACP Server, MCP Bridge, Unix Theory P7, 9 HIGH security findings fixed, chat bubble sweep |
v1.1.18 | May 2026 | Unix Theory P0โP6, DigitalOcean Serverless Inference (9th provider), async chat continuation, jobs/tasks drawer, Toolkit MCP Servers Phase 7 |
v1.1.17 | May 2026 | WP.org compliance (42/50), Chat SPA Phases 1โ7, Docs Hub v0.3.8, coverage campaign |
v1.1.16 | May 2026 | SaaS Controller Addon v0.1.0, structured logging integration, WP.org compliance hardening (B3, B8, B10, B13) |
v1.1.15 | May 2026 | OpenRouter + DeepSeek providers (7th & 8th), Orchestration Phases 1โ7, LLM Harnessing GA, Memory Bridge G-series, Graphify data-source bridge |
v1.1.14 | May 2026 | Agent Skills v2 (45 skills), Markup Subsystem (Base), MemPalace Capture Framework, Graphify CPT/CCT suite |
v1.1.13 | May 2026 | OpenAI Images 2.0 (gpt-image-2), durable agent-memory bridge Phase 4a/4b, AI Harmonization toolkit, production Composer autoloader |
v1.1.12 | Apr 2026 | Architectural Design Toolkit Phases AโE, Graphify Federation/RAG, Tier 4 Browser-AI Runtime (Transformers.js v3.8.1), security patches |
v1.1.11 | Apr 2026 | WP.org compliance hardening |
v1.1.10 | Apr 2026 | Security audit summary (0 Critical, 5 High), production vendor autoload, Veo 3.1 fix |
v1.1.9 | Apr 2026 | Measurement Subsystem GA, PHPUnit 11 upgrade, Graphify v0.5.0 restored, orchestration reference |
v1.1.8 | Apr 2026 | Erlang C workforce tools, full tool-reference audit, WP.org compliance re-audit, MCP Apps per-assistant remote connections, CRE Debt toolkit (57 tools), 36 Pro professions + 17 teams, A2A protocol, Agent Command Center, floating chat bubble, JetEngine 3.8 MCP Server bridge, Anthropic/Gemini subscription tier support |
๐ Features
Note: Some features require third-party plugins (WooCommerce, JetEngine, Elementor, etc.). See ๐ What You Lose Without Third-Party Plugins for details.
Assistant & conversation tools
๐ง Create AI Assistants via a custom post type (
mcp_ai_assistant)๐ Professional & Team Templates - Deploy assistants from ~311 pre-built profession templates spanning 12 industry categories, or create entire teams of specialists with one click. Includes backend testing for professions, teams, and assistants before public deployment.
๐ Getting Started Wizard - Guided 4-step onboarding (
/wp-admin/admin.php?page=wp-mcp-ai-getting-started) that walks new users through provider setup and use-case selection. Selecting a preset (Content Creator, Customer Support, E-commerce, SEO & Research, Developer Copilot, Media & Creative Studio, Site Administrator, or General Purpose) seeds a fully-configured assistant with tools, system prompt, and tuned temperature โ ready to use immediately.ใF:includes/admin/class-wp-mcp-ai-onboarding-wizard.phpโ L1-L53ใใF:assets/js/onboarding-wizard.jsโ L1-L303ใ๐ Automatic synchronization to JetEngine Custom Content Types when available (CPT โ CCT)
๐ฌ Chat interface via
[mcp_ai_chat assistant="ID"]๐งฐ Per-assistant defaults for model, temperature, system prompt, and knowledge attachments with permission-aware download URLs
โก Build reusable prompt shortcuts with optional tool targeting and inline descriptions so operators can trigger common tasks with one click.ใF:includes/assistants/class-wp-mcp-ai-assistant-cpt.phpโ L893-L1048ใใF:includes/class-wp-mcp-ai-shortcode.phpโ L430-L693ใใF:assets/js/chat.jsโ L600-L666ใ
๐ง Elementor widgets for embedding chat surfaces, onboarding content, and MCP dashboards inside Elementor
Language routing & knowledge management
๐ Route conversations through OpenAI or Gemini using a provider-aware language model router
๐ฏ Enhanced Gemini API integration: list models dynamically, count tokens for budget management, create embeddings for RAG/semantic search, and streaming support for real-time responsesใF:docs/reference/api/gemini/gemini-api-enhancements.mdโ L1-L100ใ
๐ง Assistant knowledge base management with Media Library files and optional vector store IDs
๐ OKF (Open Knowledge Format v0.1) engine with 6 MCP tools for curated, deterministic knowledge with cross-link navigation โ complementary to vector/RAG stores
๐ Perform lightweight web searches (DuckDuckGo or Brave) without leaving the assistant conversation
๐ Crawl4AI job runner tool for large-scale content gathering workflows
Media generation & transcription
๐ Generate speech audio via OpenAI's Text-to-Speech API and save the result to the Media Library
๐ต Generate instrumental music using Google Gemini Lyria with controls for genre, mood, tempo, and instrumentation
๐จ Generate on-brand imagery with OpenAI's Images API, honouring the configured response format (including GPT-Image-1's
urlresponses) and storing the files as WordPress attachments๐ผ๏ธ Generate images with Cloudflare Workers AI using Stable Diffusion, Flux-2 Dev, Leonardo AI (Lucid Origin, Phoenix 1.0), and other text-to-image models with configurable dimensions and generation parameters
๐ผ๏ธ Vectorize raster images (PNG, JPEG, WebP, GIF) to SVG format using @neplex/vectorizer with configurable quality settings - perfect for logos and icons
๐จ Comprehensive graphic editing with Graphic Editor Plus combining local operations (logo overlay, smart resize) and AI-powered features (style transfer, background removal, enhancement)
๐๏ธ Pro: Generate professional architectural drawings (floor plans, elevations, sections) with building codes, dimensions, and material specifications - designed for construction professionals
๐ง Transcribe or translate uploaded audio with OpenAI's speech-to-text endpoints
Commerce & finance workflows
๐ WooCommerce-aware tools (fetch orders or products, requires WooCommerce)
๐ Finance-ready QuickBooks Online reporting tool for surfacing Profit and Loss, Balance Sheet, and other statements inside assistant conversationsใF:includes/tools/class-wp-mcp-ai-tool-get-quickbooks-report.phpโ L15-L214ใใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L906-L955ใ
๐ฅ๏ธ Pro: QuickBooks Desktop sync via QODBC relay API โ connect to QuickBooks Desktop through a Windows relay server for data synchronization
๐ Pro: Shopify integration with auto-resolved connections โ
connection_idauto-resolved from assistant context, covering products, orders, customers, inventory, and catalog tools๐ Pro: Vehicle estimation tools โ VIN decode (NHTSA vPIC), image-to-repair-estimate pipeline, and car wash package pricing engine (always available)
๐ธ Pro: Listing image download tools โ bulk-download Google Maps, Facebook, and Instagram business listing images into the Media Library or ZIP
Slash Commands & Workflow Automation โญ NEW
โก 8 Core Commands:
/help,/next-task,/ship,/clean-content,/optimize-perf,/sync-docs,/workflow- Command-line style interface for content management๐ Workflow Orchestrator: Multi-step workflow execution with state management, conditional logic, and human-in-the-loop checkpoints
๐ ๏ธ 21 Pro Toolkit Commands: Specialized commands for E-commerce (6), Social Media (6), and Video Production (6) toolkits
๐ฏ 7 Automated Workflows: Pre-built workflow templates for abandoned cart recovery, social media campaigns, video marketing, inventory management, and more
๐ Security: Capability-based authorization, rate limiting, comprehensive audit logging
๐ก Integration: JavaScript autocomplete, REST API endpoint, WP-CLI support
Chat Channels & Messaging Integration โญ NEW
๐ฌ Chat Channels Toolkit (47 Tools): Integrate with 11 platforms - Telegram, WhatsApp, Slack, Discord, Microsoft Teams, Facebook Messenger, Apple Messages for Business, Google Chat/Spaces, Twitter/X, Office 365 (Outlook + OneDrive), iCloud Drive
๐ง Office 365 Integration โญ NEW: Send and retrieve Outlook mail, list/download/upload OneDrive files via Microsoft Graph API (5 tools)
โ๏ธ iCloud Drive Integration โญ NEW: List, download, and upload iCloud Drive files via a configurable gateway service (3 tools)
๐ Unified Broadcasting: Send messages across multiple platforms simultaneously with
unified_channel_broadcasttool๐ WebChat Rooms: Custom post type for real-time collaborative chat rooms with AI assistant assignment
๐ Message Persistence: JetEngine CCT integration for permanent message history
๐ WebRTC Support: Self-hosted WebRTC signaling via WordPress REST API for voice/video
๐ค AI-Powered Rooms: Assign dedicated assistants to chat rooms for automated support
Communications & outreach
โ๏ธ Mailjet-powered outbound email automation with granular capability enforcement and sender defaults configurable in the MCP settings.ใF:includes/tools/class-wp-mcp-ai-tool-send-mailjet-email.phpโ L19-L405ใใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L1008-L1054ใ
๐ Google Workspace automations for creating calendar events and searching connected Gmail inboxes directly from assistant workflows.ใF:includes/tools/class-wp-mcp-ai-tool-create-google-calendar-event.phpโ L1-L200ใใF:includes/tools/class-wp-mcp-ai-tool-search-gmail.phpโ L1-L200ใ
๐งพ JetFormBuilder orchestration for listing forms, reviewing submissions, and proxying REST calls on behalf of assistants (requires JetFormBuilder)
๐ JetEngine REST route reference tool for surfacing endpoint metadata inside AI workflows
๐งฑ Ready for extension with ChatKit integration
Integrations, security & controls
๐ง Tool Registry for registering PHP functions callable by the AI
โ๏ธ JetEngine integration for dynamic content queries (requires JetEngine)
๐ JetEngine 3.8 MCP Server Bridge โญ NEW - JSON-RPC 2.0 client bridges NV oOS into JetEngine's native MCP Server with 7 new Pro tools for CPT/taxonomy/meta field creation, relations management, site context grounding, and prompt template access. MCP-first dispatch with REST v2 fallback.
๐ค Agent-to-Agent (A2A) Protocol โญ NEW - Full A2A protocol making NV oOS assistants discoverable and interoperable with any A2A-compliant agent.
/.well-known/agent.jsondiscovery, JSON-RPC 2.0 server with task state machine, A2A client for remote agent delegation, push notification webhooks.๐ Agent Command Center โญ NEW - Unified agent management dashboard with 7 tabs: Overview (KPI cards, live status), Activity Log, Active Tasks, Approvals (human-in-the-loop), Analytics (Chart.js with real per-agent metrics), Uptime & Health, and Strategy (efficiency scoring with recommendations).
๐ฌ Floating Chat Bubble โญ NEW - Configurable floating chat bubble widget for Elementor and Gutenberg. 4 position variants, 3 sizes, bounce/pulse animations, dark mode, WCAG focus states, sessionStorage persistence.
๐งท Granular control over allowed attachment MIME types for chat uploads
๐ Secure REST API endpoints
๐ Root Security Key - Optional wp-config.php constant that can be enabled during emergency shutdown to require authentication before re-initializing the plugin. Provides an additional layer of protection against unauthorized reactivation after security incidents.ใF:docs/features/security/root-security-key.mdโ L1-L511ใใF:includes/class-wp-mcp-ai-root-security-key.phpโ L1-L360ใ
๐ฐ Assistant directory endpoint that advertises MCP tool/resource capabilities and negotiates Server-Sent Events handshakes for clients such as LM Studio or Claude Desktop.ใF:includes/class-wp-mcp-ai-rest.phpโ L520-L666ใใF:includes/class-wp-mcp-ai-rest.phpโ L1690-L1772ใ
๐ Full JSON-RPC 2.0 MCP endpoint (
/mcp) for standards-compliant remote client communication๐ Configurable API credentials and defaults for OpenAI, Gemini, and Anthropic (with subscription tier support for Team/Enterprise plans and custom base URLs)
๐ค ChatGPTโs connector beta currently requires an Auth0 tenant; the pluginโs assistant credentials are compatible with LM Studio, Claude, and other MCP clients that support bearer headers directly.ใF:docs/reference/api/mcp-server-authentication.mdโ L22-L46ใ
๐ Mesh networking for distributed compute pooling across multiple WordPress sites. Server-to-server architecture enables anonymous and authenticated users to benefit from shared AI resources, budget pooling, and workload distribution across 100+ trusted peer sites. Backend assistants coordinate mesh operations via secure inter-site keys while maintaining user attribution and audit trails for compliance.ใF:docs/features/federation/mesh-compute-pooling.mdโ L1-L615ใใF:includes/tools/class-wp-mcp-ai-tool-query-remote-site.phpโ L1-L237ใ
๐ Federation & Discovery - Decentralized AI capability network allowing WordPress sites to publish their capabilities via well-known endpoints (
/.well-known/ai-peer) and discover peer sites through directory services. Supports peer registration, health verification, search & ranking by capability/region/policy, and automatic cron-based health monitoring. Enable federation to join the network or run your own directory service for private peer discovery.ใF:docs/features/federation/federation-discovery.mdโ L1-L511ใใF:FEDERATION-IMPLEMENTATION-SUMMARY.mdโ L1-L381ใ๐งพ Optional logging of chat interactions, tool executions, and API errors
๐งฎ Built-in per-user usage tracking for provider/model billing summaries
๐งฉ Developer hooks and filters for integrating custom behaviours
โฑ Per-site request timeout control with sensible minimum enforcement
๐ Toggleable uninstall cleanup to purge stored assistants and settings automatically
Performance & reliability
โก Client-side message bundling (800ms window) to reduce API calls and server loadใF:docs/user-guides/chat/message-bundling-feature.mdโ L1-L80ใ
๐ฏ Intelligent token overflow handling with automatic model switching (gpt-4.1-mini โ Gemini 2.0 Flash)ใF:docs/features/tools/presets/high-token-tool-handling.mdโ L1-L80ใ
๐ก Server-Sent Events (SSE) support for real-time streaming responses and job notificationsใF:docs/features/streaming/ENABLE-SSE-STREAMING.mdโ L1-L100ใ
๐ Real-time job status updates via SSE streaming and webhook notifications for async operationsใF:docs/features/async-jobs/job-notification-system.mdโ L1-L100ใ
๐ง Symfony Process Component - Modern process execution framework replacing direct
exec()calls in Pro addon tools for enhanced security, timeout management, and error handlingใF:includes/services/class-wp-mcp-ai-process-service.phpโ L1-L220ใใF:docs/history/2025/implementations/symfony-phases/SYMFONY_PHASE2B_PROCESS_INTEGRATION.mdโ L1-L100ใ๐ Server-side WP-Cron polling for long-running tasks (Crawl4AI, background jobs)
๐พ Chat history persistence with localStorage (24h) and optional JetEngine CCT storageใF:docs/user-guides/chat/chat-history-persistence.mdโ L1-L50ใ
โ๏ธ Optimized settings page with external CSS stylesheet (240 lines added to admin-settings.css) and request-level caching for improved admin performanceใF:assets/css/admin-settings.cssโ L1-L984ใใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L27-L32ใ
Settings Management โญ NEW
๐ง Robust Settings System - 7-step save process with automatic backups, validation, and cache management ensures settings persist correctly across all tabs and subtabsใF:includes/admin/class-wp-mcp-ai-settings-dashboard.phpโ L262-L410ใ
๐ Health Check - Run 6 diagnostic checks to verify settings integrity, provider configuration, and system status with GOOD/WARNING/CRITICAL status indicatorsใF:includes/admin/sections/class-wp-mcp-ai-section-advanced.phpโ L1500-L1650ใ
๐พ Export Settings - Download all plugin settings as timestamped JSON files for backup or migration to other sitesใF:docs/admin-guides/settings-management.mdโ L40-L80ใ
๐ค Import Settings - Upload and validate settings from previously exported backups with automatic pre-import backup and 5-step validationใF:docs/admin-guides/settings-management.mdโ L85-L135ใ
๐๏ธ Clear Cache - One-click clearing of static cache, object cache, and transients when settings changes don't take effectใF:docs/admin-guides/settings-management.mdโ L140-L165ใ
โฉ๏ธ Reset to Defaults - Safely reset all settings to default values with automatic backup before resetใF:docs/admin-guides/settings-management.mdโ L170-L200ใ
๐ Security - File size validation (max 5MB), MIME type checking, JSON validation, and comprehensive input sanitizationใF:includes/admin/class-wp-mcp-ai-settings-dashboard.phpโ L970-L1030ใ
๐ Automatic Backups - Every save operation creates a timestamped backup (keeps last 5) for emergency recoveryใF:includes/admin/class-wp-mcp-ai-settings-dashboard.phpโ L285-L295ใ
๐ก๏ธ Data Protection - 3-layer protection (section filtering, merge strategy, sensitive key filtering) prevents accidental data loss when saving from tabs/subtabsใF:docs/admin-guides/settings-management.mdโ L230-L280ใ
๐ Pro Toolkits - Enable and configure 8 specialized Pro toolkits (650+ tools) including Project Management, Document Generation, Health & Wellness, CRE Debt & Securitization, and moreใF:docs/admin-guides/pro-settings-toolkits.mdโ L1-L650ใ
โก๏ธ Complete Documentation: Settings Management Guide | Quick Reference | Visual UI Guide | Pro Toolkits Guide
๐ง Memory & Tool Stack Overview
Model defaults
Global settings capture the default provider, model, and timeout used when assistants are created, ensuring every conversation inherits stable generation behaviour until explicitly overridden. These defaults ship with sensible values for OpenAI and Gemini out of the box and can be tailored from the NV oOS settings screen.ใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L36-L77ใ
Base knowledge
Each assistant can preload Media Library files and optionally link to an external vector store, giving the model persistent project context before a chat begins. Editors manage these knowledge sources from the assistant post type via the โBase Knowledgeโ meta box, which supports multiple attachments and vector store identifiers.ใF:includes/assistants/class-wp-mcp-ai-assistant-cpt.phpโ L892-L1002ใ
Available tools
The tool registry boots with a curated catalogue of content, commerce, automation, and research utilities, then exposes hooks so developers can register their own providers. During initialisation the registry loads each bundled tool classโranging from JetEngine accessors to Crawl4AI jobs and Mailjet automationsโand makes them callable within conversations.ใF:includes/class-wp-mcp-ai-tool-registry.phpโ L74-L220ใ
Chat-client Memory Drawer
The chat front-end exposes a persistent Memory Drawer (assets/js/chat-memory-drawer.js) with three tabs:
Memories โ browse, pin, and delete stored context items; ๐ง badge auto-appears on any assistant message that used a memory tool.
Scope โ set the active wing/room scope for subsequent memory operations in the current session.
Audit โ lazy-loaded audit trail from
WP_MCP_AI_REST_Chat_Memory_Controller::audit().
The drawer is wired to the REST proxy at /mcp-ai/v1/chat-memory/ and receives real-time updates via the memory_event SSE frame emitted by the agentic loop. Pagehide auto-capture stores the session state before tab close. Two gates control access: site-wide filter wp_mcp_ai_chat_memory_enabled and per-user meta wp_mcp_ai_chat_memory_enabled. Full reference: docs/features/memory/chat-client-integration.md.
Retroactive Transcript Mining
WP_MCP_AI_Transcript_Mining_Job retrospectively extracts memories from past chat transcripts. Enqueue a job via POST /mcp-ai/v1/transcript-mining/jobs (admin-only), poll progress with GET /jobs/{id}, or cancel with POST /jobs/{id}/cancel. Full reference: docs/features/memory/transcript-mining.md.
LLM Harnessing Subsystem
Seven opt-in per-request layers (includes/harness/) improve response quality without changing existing tool behaviour. Activated per-assistant via the LLM Harness metabox. Layers: A Prompt/Cue โ B Reasoning Trace โ C Tool Routing โ D Retrieval โ E Self-Refine โ F Memory Scoping + PII Filter โ G Eval Scheduler. Pro Layer H exports fine-tune curricula as OpenAI JSONL. Full reference: docs/features/llm-harness.md.
Workflow families & tool combos
The core plugin ships with a centrally registered tool catalogue that lets assistants mix and match capabilities into cohesive workflows without additional coding. Teams can chain authoring, media, research, commerce, marketing, and operational tools to deliver end-to-end outcomes inside a single conversation.
Content & knowledge production โ Combine
submit_document_prompt,search_content, andsearch_attachmentsto gather source material, then follow up withsave_post,create_wpcode_snippet, orget_rankmath_seofor structured drafting and optimisation.Media generation & transcription โ Pair
generate_openai_image,generate_gemini_image,vectorize_image, orgraphic_editor_pluswithgenerate_openai_speechandtranscribe_openai_audioto build multimedia assets that flow into editorial or marketing outputs. Usevectorize_imageto convert logos to scalable vectors, andgraphic_editor_plusfor comprehensive image editing with both local and AI-powered operations.Research & situational awareness โ Chain discovery helpers like
web_search,run_crawl4ai_job,reliefweb_reports,get_gdacs_events, andget_nhc_active_stormsto assemble briefing packs before drafting follow-up actions.Commerce & finance operations โ Use WooCommerce and finance tools such as
create_woo_product,get_woo_products,get_woo_recent_orders,crawl4ai_price_lookup,get_import_duty, andquickbooks_reportto coordinate merchandising, pricing, and bookkeeping reviews.Marketing & analytics insights โ Combine measurement tools including
google_analytics_report,get_google_business_insights,get_facebook_instagram_insights,get_linkedin_insights, andget_tiktok_insightsto guide campaigns and reporting.Publishing & outreach automations โ Trigger distribution via
post_facebook_instagram,post_google_business_update,post_linkedin_update,post_tiktok_video,send_group_email,send_mailjet_email,send_telegram_message,send_whatsapp_message, andschedule_notify_smsonce plans are ready.Integrations & scheduling โ Connect external systems with
create_google_calendar_event,search_gmail,list_jetengine_rest_routes,invoke_jetengine_route, andrun_openai_external_actionas part of larger automations.Operations & diagnostics โ Close the loop with
create_cron_job,list_cron_jobs,get_cron_job,delete_cron_job,check_wp_cli,purge_cache,purge_cloudflare_cache,purge_varnish_cache,get_site_summary,get_site_health,get_system_logs,get_update_status, and OpenAI usage/log review helpers for monitoring and maintenance.Automation & scheduling workflows โ Agents can autonomously schedule background tasks with
create_cron_job, monitor scheduled operations vialist_cron_jobsandget_cron_job, and clean up outdated automations withdelete_cron_job. Combine with cache management tools (purge_cache,purge_cloudflare_cache,purge_varnish_cache) to orchestrate content publishing workflows where agents schedule posts, then automatically invalidate caches at publication time.
๐ Built-in tools & automations
The assistant registry ships with a comprehensive catalogue of editorial, marketing, commerce, and operational helpers. The tables below outline every bundled tool and the slug assistants call when orchestrating workflows.
Content & knowledge workflows
Tool | Slug | Summary |
Submit Document Prompt |
| Uploads WordPress attachments or OpenAI file IDs alongside an instruction so multimodal prompts reach the Responses API with the required file context.ใF:includes/tools/class-wp-mcp-ai-tool-submit-document-prompt.phpโ L20-L214ใ |
Search Content |
| Queries public post types with optional taxonomy and meta filters to surface structured post metadata for the assistant.ใF:includes/tools/class-wp-mcp-ai-tool-search-content.phpโ L12-L280ใ |
Search Attachments |
| Scans the Media Library with keyword or MIME filters while honouring attachment capability checks and signed download URLs.ใF:includes/tools/class-wp-mcp-ai-tool-search-attachments.phpโ L15-L207ใ |
Get Recent Posts |
| Returns the latest entries for a given post type with titles, permalinks, excerpts, and timestamps for quick editorial summaries.ใF:includes/tools/class-wp-mcp-ai-tool-get-recent-posts.phpโ L12-L104ใ |
Get Elementor Templates |
| Lists Elementor library templates with status, type, and edit links when Elementor is available and the caller has access.ใF:includes/tools/class-wp-mcp-ai-tool-get-elementor-templates.phpโ L12-L239ใ |
Get JetEngine Items |
| Retrieves JetEngine-managed content with capability-aware access checks for each registered custom post type.ใF:includes/tools/class-wp-mcp-ai-tool-get-jetengine-items.phpโ L12-L118ใ |
Get JetFormBuilder Forms |
| Proxies JetFormBuilder REST controllers to return paginated form metadata with automatic REST/HTTP fallbacks.ใF:includes/tools/class-wp-mcp-ai-tool-get-jetformbuilder-forms.phpโ L15-L155ใ |
Get JetFormBuilder Submissions |
| Lists recent JetFormBuilder entries with normalised field snapshots and capability enforcement.ใF:includes/tools/class-wp-mcp-ai-tool-get-jetformbuilder-submissions.phpโ L15-L154ใ |
Save Post |
| Drafts or updates posts and custom post types with sanitised Gutenberg content, slug/title overrides, and edit links.ใF:includes/tools/class-wp-mcp-ai-tool-save-post.phpโ L15-L268ใ |
Create WPCode Snippet ๐ |
| Provisions or updates WPCode-managed snippets, validating code types, insert locations, and activation status. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-create-wpcode-snippet.phpโ L15-L224ใ |
Get Rank Math SEO Overview |
| Surfaces Rank Math SEO scores, focus keywords, robots metadata, and schema details for a specific post when the plugin is active.ใF:includes/tools/class-wp-mcp-ai-tool-get-rankmath-seo.phpโ L15-L220ใ |
Get User Information |
| Inspects the acting user or a supplied account while respecting multisite membership and capability requirements.ใF:includes/tools/class-wp-mcp-ai-tool-get-user-info.phpโ L12-L89ใ |
Media generation & transcription
Tool | Slug | Summary |
Generate OpenAI Image |
| Calls the OpenAI Images API with configurable defaults, saving the rendered asset to the Media Library with optional overrides.ใF:includes/tools/class-wp-mcp-ai-tool-generate-openai-image.phpโ L17-L218ใ |
Generate Gemini Image |
| Uses Geminiโs multimodal image endpoint to render creative, aspect-ratio-aware visuals that are persisted as WordPress attachments.ใF:includes/tools/class-wp-mcp-ai-tool-generate-gemini-image.phpโ L17-L200ใ |
Generate Cloudflare AI Image |
| Creates images using Cloudflare Workers AI text-to-image models including Stable Diffusion XL, Flux-2 Dev, Leonardo AI (Lucid Origin, Phoenix 1.0), and Dreamshaper with configurable dimensions, steps, and guidance parameters. |
Vectorize Image |
| Converts raster images (PNG, JPEG, WebP, GIF) to SVG vector format with configurable quality settings using @neplex/vectorizer. Perfect for logos, icons, and graphics. Requires Node.js 14+.ใF:includes/tools/class-wp-mcp-ai-tool-vectorize-image.phpโ L1-L430ใ |
Graphic Editor Plus |
| Comprehensive image editing with local operations (logo overlay, resize) and AI-powered features (style transfer, background removal, enhancement). Combines speed with intelligent transformations.ใF:includes/tools/class-wp-mcp-ai-tool-graphic-editor-plus.phpโ L1-L784ใ |
Generate Architectural Drawing ๐ |
| [PRO] Creates professional architectural drawings (floor plans, elevations, sections, details) for construction projects. Supports 10 drawing types, 6 presentation styles (technical, sketched, rendered), dimensional specifications, building codes (IBC, IRC, NBC, Eurocode), and material lists. Outputs PNG or SVG with automatic vectorization. Perfect for architects, engineers, and construction professionals.ใF:addons/pro/includes/tools/class-wp-mcp-ai-tool-generate-architectural-drawing.phpโ L1-L1136ใ |
Generate OpenAI Speech |
| Converts text to audio via OpenAIโs text-to-speech models, honouring default voice/format selections and storing results in the Media Library.ใF:includes/tools/class-wp-mcp-ai-tool-generate-openai-speech.phpโ L17-L199ใ |
Generate Music |
| Creates instrumental music from text descriptions using Google Gemini Lyria model with controls for genre, mood, duration, and tempo. |
Transcribe OpenAI Audio |
| Sends uploaded audio to OpenAIโs transcription/translation endpoints and returns structured transcripts with language and duration metadata.ใF:includes/tools/class-wp-mcp-ai-tool-transcribe-openai-audio.phpโ L17-L195ใ |
Research & situational awareness
Tool | Slug | Summary |
Web Search |
| Performs lightweight lookups against DuckDuckGo or Brave, normalising related topics and enforcing per-user result caps.ใF:includes/tools/class-wp-mcp-ai-tool-web-search.phpโ L12-L320ใ |
Run Crawl4AI Job |
| Executes Crawl4AI harvests locally or remotely, collecting Markdown, HTML, and error payloads for long-form content ingestion workflows.ใF:includes/tools/class-wp-mcp-ai-tool-run-crawl4ai-job.phpโ L32-L745ใ |
ReliefWeb Reports |
| Queries ReliefWebโs humanitarian dataset by country or disaster type and returns structured report metadata for situational updates.ใF:includes/tools/class-wp-mcp-ai-tool-reliefweb-reports.phpโ L15-L234ใ |
Get GDACS Events |
| Fetches Global Disaster Alert and Coordination System events with optional date filters and capability checks for emergency planning.ใF:includes/tools/class-wp-mcp-ai-tool-get-gdacs-events.phpโ L12-L200ใ |
Get NHC Active Storms |
| Retrieves the National Hurricane Centerโs active storm feed, sanitising advisory data for assistant consumption.ใF:includes/tools/class-wp-mcp-ai-tool-get-nhc-active-storms.phpโ L15-L146ใ |
Get Open-Meteo Forecast |
| Pulls hourly weather data from Open-Meteo with coordinate, timezone, and variable controls for itinerary-aware responses.ใF:includes/tools/class-wp-mcp-ai-tool-get-open-meteo-forecast.phpโ L15-L309ใ |
Vision Product Search |
| Searches for similar products using Google Cloud Vision API Product Search feature. Note: Requires proper Google Cloud authentication credentials to succeed.ใF:includes/tools/class-wp-mcp-ai-tool-vision-product-search.phpโ L1-L200ใ |
Vision Object Localization |
| Detects and localizes multiple objects in images using Google Cloud Vision API. Note: Requires proper Google Cloud authentication credentials to succeed.ใF:includes/tools/class-wp-mcp-ai-tool-vision-object-localization.phpโ L1-L200ใ |
Commerce & finance operations
Tool | Slug | Summary |
Create WooCommerce Product Draft |
| Builds draft WooCommerce products with merchandising copy, pricing, images, and brand metadata when WooCommerce is active.ใF:includes/tools/class-wp-mcp-ai-tool-create-woo-product.phpโ L15-L258ใ |
Get WooCommerce Products |
| Surfaces catalogue listings with pricing, stock status, and optional SKU/status filters for merchandiser reviews.ใF:includes/tools/class-wp-mcp-ai-tool-get-woo-products.phpโ L12-L140ใ |
Get Woo Recent Orders |
| Summarises recent WooCommerce orders with totals, billing details, and ISO timestamps for fulfilment teams.ใF:includes/tools/class-wp-mcp-ai-tool-get-woo-recent-orders.phpโ L12-L117ใ |
Wholesale Club Price Lookup |
| Uses Crawl4AIโs web search endpoint to compare BJโs, Samโs Club, and Costco pricing for a given product query.ใF:includes/tools/class-wp-mcp-ai-tool-crawl4ai-price-lookup.phpโ L17-L189ใ |
Lookup Import Duty ๐ |
| Queries the ITA Tariff Rates API for HS codes or descriptions to surface import duty rates for supported countries. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-get-import-duty.phpโ L15-L152ใ |
QuickBooks Online Report ๐ |
| Requests Profit & Loss, Balance Sheet, or custom QuickBooks Online reports with optional date ranges and accounting methods. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-get-quickbooks-report.phpโ L15-L214ใ |
Marketing & analytics insights
Tool | Slug | Summary |
Google Analytics Report ๐ |
| Runs GA4 Analytics Data API queries with metrics, dimensions, date ranges, and aggregation controls to monitor site performance. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-get-google-analytics-report.phpโ L15-L158ใ |
Google Business Insights |
| Fetches Google Business Profile metrics for a location using OAuth tokens, time ranges, and timezone hints. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-get-google-business-insights.phpโ L15-L149ใ |
Meta Social Insights |
| Pulls Facebook Page or Instagram business metrics via the Graph API with selectable periods and metric sets. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-get-facebook-instagram-insights.phpโ L15-L146ใ |
LinkedIn Insights |
| Queries LinkedIn organizational share statistics with optional timeframe and granularity filters. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-get-linkedin-insights.phpโ L15-L138ใ |
TikTok Insights |
| Calls the TikTok Open API to return account performance metrics across configurable windows and granularities. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-get-tiktok-insights.phpโ L15-L136ใ |
Get Cross-Platform Analytics ๐ |
| [NEW Jan 2026] Unified social media metrics dashboard aggregating data from Facebook, Instagram, Twitter, LinkedIn, and YouTube. Provides engagement rates, follower growth, post performance, and comparative analytics across all platforms. Built-in 12-hour caching. Pro addon tool (623 lines). |
Track Hashtag Performance ๐ |
| [NEW Jan 2026] Comprehensive hashtag analysis tracking reach, engagement, impressions, and trend data across Facebook, Instagram, Twitter, LinkedIn, and YouTube. Identifies top-performing hashtags and provides optimization recommendations. Pro addon tool (586 lines). |
Competitor Analysis ๐ |
| [NEW Jan 2026] Track competitor social media metrics and benchmark performance against your profiles. Monitors follower growth, engagement rates, posting frequency, and content strategies across all major platforms. Pro addon tool (711 lines). |
Influencer Identification ๐ |
| [NEW Jan 2026] Discover brand influencers and potential collaboration partners based on reach, engagement criteria, audience demographics, and content relevance. Searches across Facebook, Instagram, Twitter, LinkedIn, and YouTube. Pro addon tool (759 lines). |
Publishing & outreach
Tool | Slug | Summary |
Publish Meta Social Post ๐ |
| Publishes Facebook Page or Instagram business posts through the Meta Graph API with message, caption, and media controls. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-post-facebook-instagram.phpโ L15-L170ใ |
Publish Google Business Update ๐ |
| Creates Google Business Profile local posts with summaries, language codes, and optional call-to-action links. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-post-google-business-update.phpโ L15-L168ใ |
Publish LinkedIn Update ๐ |
| Sends LinkedIn UGC posts for members or organisations with optional share URLs via the LinkedIn Marketing API. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-post-linkedin-update.phpโ L15-L160ใ |
Publish TikTok Video ๐ |
| Submits hosted video assets to TikTokโs Open API share endpoint with optional captions. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-post-tiktok-video.phpโ L15-L152ใ |
Send Group Email |
| Orchestrates structured or free-form email campaigns with capability-based audience limits and logging hooks. Full documentation.ใF:includes/tools/class-wp-mcp-ai-tool-send-group-email.phpโ L16-L650ใ |
Send Mailjet Email ๐ |
| Delivers transactional and marketing emails through Mailjet with sender defaults, CC/BCC routing, and response metadata. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-send-mailjet-email.phpโ L19-L405ใ |
Send Telegram Message ๐ |
| Posts formatted updates to Telegram chats or channels with capability filters and audit logging. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-send-telegram-message.phpโ L16-L232ใ |
Send WhatsApp Message ๐ |
| Sends WhatsApp Cloud API text messages with preview controls using phone-number specific access tokens. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-send-whatsapp-message.phpโ L15-L178ใ |
Schedule Notify.lk SMS ๐ |
| Queues Notify.lk SMS messages for future delivery using the official SDK and site cron orchestration. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-schedule-notify-sms.phpโ L15-L180ใ |
Integrations & scheduling
Tool | Slug | Summary |
Create Google Calendar Event |
| Builds calendar events with attendees, reminders, and timeout overrides using OAuth tokens or service accounts.ใF:includes/tools/class-wp-mcp-ai-tool-create-google-calendar-event.phpโ L17-L378ใ |
Search Gmail Messages |
| Performs delegated Gmail queries with optional label filters and pagination, returning normalised message metadata. Pro addon tool.ใF:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-search-gmail.phpโ L1-L200ใ |
List JetEngine REST Routes |
| Enumerates JetEngine REST endpoints with method, callback, and capability metadata for developers.ใF:includes/tools/class-wp-mcp-ai-tool-list-jetengine-routes.phpโ L12-L151ใ |
Invoke JetEngine REST Route |
| Proxies JetEngine CRUD operations using the authenticated user context with REST/HTTP fallbacks.ใF:includes/tools/class-wp-mcp-ai-tool-invoke-jetengine-route.phpโ L12-L133ใ |
Run OpenAI External Action |
| Triggers OpenAI Responses API workflows or assistants with payload sanitisation, timeout overrides, and structured errors.ใF:includes/tools/class-wp-mcp-ai-tool-run-openai-external-action.phpโ L17-L211ใ |
Operations & diagnostics
Tool | Slug | Summary |
Cron Management Suite | AI agents can autonomously schedule, monitor, and manage WordPress background tasks | |
Create Cron Job |
| Schedules one-off or recurring WP-Cron events with duplicate detection and sanitised hooks/arguments. Agents can automate periodic maintenance, content publishing, or custom workflows by scheduling actions to run at specific times or intervals.ใF:includes/tools/class-wp-mcp-ai-tool-create-cron-job.phpโ L16-L168ใ |
List Cron Jobs |
| Lists all scheduled WordPress cron jobs with details about schedule, next run time, and creator. Enables agents to provide visibility into scheduled automation tasks and audit what background processes are running.ใF:includes/tools/class-wp-mcp-ai-tool-list-cron-jobs.phpโ L17-L141ใ |
Get Cron Job |
| Retrieves detailed information about a specific WordPress cron job by its job ID, including schedule interval details and execution metadata. Allows agents to inspect individual scheduled tasks for troubleshooting or reporting.ใF:includes/tools/class-wp-mcp-ai-tool-get-cron-job.phpโ L17-L145ใ |
Delete Cron Job |
| Deletes a scheduled WordPress cron job and removes it from both the plugin tracking and WP-Cron. Enables agents to cancel outdated or unnecessary automation tasks on behalf of operators.ใF:includes/tools/class-wp-mcp-ai-tool-delete-cron-job.phpโ L17-L90ใ |
Cache Management | AI agents can coordinate multi-layer cache invalidation | |
Purge Cache |
| Master cache purge tool that coordinates multi-layer cache clearing (Cloudflare, Varnish, etc.) in the correct order. Agents can ensure content updates are properly reflected across all caching layers.ใF:includes/tools/class-wp-mcp-ai-tool-purge-cache.phpโ L17-L150ใ |
Purge Cloudflare Cache |
| Sends targeted or full-zone invalidations to Cloudflare with configurable timeouts and admin-only access controls.ใF:includes/tools/class-wp-mcp-ai-tool-purge-cloudflare-cache.phpโ L17-L292ใ |
Purge Varnish Cache |
| Purges the local Varnish cache with support for full-cache bans and specific URL purges. Agents can clear server-side caching to ensure immediate content updates.ใF:includes/tools/class-wp-mcp-ai-tool-purge-varnish-cache.phpโ L17-L150ใ |
System Monitoring & Diagnostics | ||
Check Site Security |
| Checks if the WordPress site has security vulnerabilities that make it unsafe to use this AI plugin. Scans for common security issues and provides remediation guidance for administrators.ใF:includes/tools/class-wp-mcp-ai-tool-check-site-security.phpโ L1-L200ใ |
Check WP-CLI Status |
| Scans for the WordPress CLI binary, returning detected paths, version output, and environment warnings.ใF:includes/tools/class-wp-mcp-ai-tool-check-wp-cli.phpโ L17-L309ใ |
Count Tokens |
| Estimates token counts for text and messages using heuristic estimation (approximately 4 characters per token) for planning and budgeting purposes. Helps with capacity planning before sending requests to AI providers.ใF:includes/tools/class-wp-mcp-ai-tool-count-tokens.phpโ L1-L200ใ |
Get Site Summary |
| Provides high-level site metadata, content counts, and admin contact details for context-aware assistants.ใF:includes/tools/class-wp-mcp-ai-tool-get-site-summary.phpโ L12-L66ใ |
Get MCP Environment Status |
| Summarises WordPress versions, MCP defaults, assistant counts, and dependency warnings for incident response.ใF:includes/tools/class-wp-mcp-ai-tool-get-environment-status.phpโ L12-L178ใ |
Get Site Health Status |
| Runs WordPress Site Health diagnostics and returns grouped pass/warn/fail tests with remediation guidance.ใF:includes/tools/class-wp-mcp-ai-tool-get-site-health.phpโ L12-L255ใ |
Get System Logs |
| Aggregates NV oOS logs, WordPress/PHP error logs, and plugin log files to aid in debugging workflows.ใF:includes/tools/class-wp-mcp-ai-tool-get-system-logs.phpโ L12-L352ใ |
Get Update Status |
| Reports pending core, plugin, and theme updates with version and download metadata for maintenance planning.ใF:includes/tools/class-wp-mcp-ai-tool-get-update-status.phpโ L12-L182ใ |
Testing & Validation | ||
Probe Assistant Chat |
| Issues a chat probe against a published assistant to confirm sanitisation, configuration, and REST handling without consuming model tokens.ใF:includes/tools/class-wp-mcp-ai-tool-probe-chat.phpโ L12-L178ใ |
Probe Remote MCP REST |
| Reuses the remote connectivity tester to exercise |
Mesh Networking | Distributed compute pooling across WordPress sites | |
Query Remote Site |
| Executes chat requests on peer WordPress sites in a mesh network. Requires |
Query Mesh (Intelligent Routing) |
| Send a prompt to the mesh network with AI-powered peer selection and automatic failover. The system intelligently routes requests to the optimal peer site based on current load, response times, and task complexity. Provides resilient distributed compute with automatic retry logic.ใF:includes/tools/class-wp-mcp-ai-tool-query-mesh-intelligent.phpโ L1-L300ใ |
Provider Dashboards | ||
Open OpenAI Logs |
| Returns dashboard shortcuts for reviewing OpenAI request logs in the provider console.ใF:includes/tools/class-wp-mcp-ai-tool-open-openai-logs.phpโ L12-L66ใ |
Open OpenAI Usage |
| Provides direct links to OpenAI usage dashboards so admins can audit consumption quickly.ใF:includes/tools/class-wp-mcp-ai-tool-open-openai-usage.phpโ L12-L66ใ |
Authentication | ||
Generate Simple JWT Token |
| Generates a Simple JWT Login bearer token for the current user, enabling authenticated API access across sessions. Agents can help users obtain authentication tokens for headless WordPress integrations.ใF:includes/tools/class-wp-mcp-ai-tool-generate-simple-jwt-token.phpโ L15-L120ใ |
What the Cron Manager means to AI agents
The Cron Management Suite transforms AI assistants from reactive responders into proactive automation orchestrators. By providing full control over WordPress's background task scheduler, agents can:
Autonomous Task Scheduling
Schedule content publishing workflows to go live at optimal times without human intervention
Automate recurring maintenance tasks like cache clearing, database optimization, or backup operations
Coordinate multi-step operations that span hours or days by chaining scheduled hooks
Intelligent Monitoring & Self-Management
List and inspect all scheduled tasks to understand what automation is currently active
Audit who created each task and when it's scheduled to run next
Identify and remove outdated or redundant scheduled tasks to maintain system health
Real-World Agent Workflows
Content Calendar Automation - An agent helping with content strategy can schedule posts to publish at researched optimal engagement times, set up recurring social media cross-posts, and schedule follow-up email campaigns.
Site Maintenance Orchestration - When troubleshooting performance issues, agents can schedule off-peak cache purges, coordinate database cleanup tasks, and set up recurring health check notifications.
Business Process Automation - Agents can schedule recurring report generation, periodic data syncs with external systems, and automated backup verification checks.
Technical Implementation
The cron manager tracks all scheduled tasks in wp_mcp_ai_cron_jobs option with full audit trails including:
Job ID for unique identification
Hook name and sanitized arguments
Schedule type (single-run or recurring interval)
Creation timestamp and user attribution
Next execution time for monitoring
Jobs are automatically pruned when they complete (single-run) or are manually removed (recurring), keeping the tracking database clean. All cron operations require manage_options capability, ensuring only authorized users can delegate automation authority to agents.ใF:includes/class-wp-mcp-ai-cron-manager.phpโ L12-L280ใ
Each tool inherits the assistant context and authenticated user from the REST layer, making it easy to layer custom permissions or extend behaviour via the documented filters and actions.ใF:includes/class-wp-mcp-ai-rest.phpโ L236-L360ใใF:includes/class-wp-mcp-ai-rest.phpโ L1124-L1198ใ
Need per-tool prerequisites or capability callouts? Consult docs/reference/tools/tool-reference.md for a detailed matrix of every bundled integration.
Tool Status Labels
The Tools Manager page displays status labels beside tool names to indicate their development stage and stability:
Status | Display Label | Description | Auto-Disable |
stable | STA | Production-ready, fully tested tools safe for all environments | No |
beta | BET | Testing phase, mostly stable but may have minor issues | No |
dev | DEV | In active development, may have bugs or incomplete features | No |
experimental | EXP | New features that may change significantly | No |
bug | BUG | Known issues exist, use with caution | Yes |
deprecated | DEP | Will be removed in future versions | No |
Status labels are displayed as 3-letter abbreviations (e.g., "STA" for stable, "BET" for beta) to keep the UI compact.
Important: Tools marked with the bug status are automatically disabled when the plugin loads. This prevents problematic tools from being used until issues are resolved. Administrators can manually re-enable them from the Tools Manager if needed for testing.
Status labels are managed via the tool-status.txt file in the repository. To assign a status label to a tool:
Open
docs/tool-status.txtin a text editorAdd a line in the format:
tool_slug = status_labelSave the file - changes appear immediately in the Tools Manager
Example:
create_post = stable
web_search = beta
generate_openai_image_validated = experimental
problematic_tool = bugThis file-based approach allows quick status updates without code changes, making it easy for maintainers to reflect tool maturity as development progresses. The automatic disabling of buggy tools provides an additional safety layer to prevent issues in production environments.
๐จ๏ธ Front-end chat surfaces
NV oOS ships multiple ways to embed assistants on the front end:
Classic chat shortcode โ
[mcp_ai_chat]renders the bundled interface with attachment uploads, tool invocation feedback, and optional guest access viaallow_guests="true". When guest mode is enabled, the shortcode provisions a temporary token and injects it into the JavaScript bootstrap so visitors without WordPress accounts can continue chatting while still respecting capability checks and attachment safety limits.ใF:includes/class-wp-mcp-ai-shortcode.phpโ L132-L258ใใF:includes/class-wp-mcp-ai-shortcode.phpโ L188-L226ใFloating chat bubble โญ NEW โ A configurable floating button that sits at a screen corner and opens a chat panel powered by the
[mcp_ai_chat]shortcode. Available as both an Elementor widget and a Gutenberg block. Supports 4 position variants, 3 sizes, auto-open delay, session persistence, dark mode, and WCAG keyboard navigation.ใF:includes/elementor/class-wp-mcp-ai-elementor-chat-bubble-widget.phpโ L1-L200ใใF:includes/blocks/chat-bubble/block.jsonโ L1-L50ใElementor widgets โ Drop the chat UI anywhere Elementor is active, pair it with intro/FAQ blocks, and surface dashboard telemetry without custom code. The chat widget mirrors the shortcode controls (including
allow_guests), and companion widgets expose onboarding content, usage timers, provider quick links, and activity feeds for operational views.ใF:includes/elementor/class-wp-mcp-ai-elementor-widget.phpโ L79-L138ใใF:includes/class-wp-mcp-ai-elementor-integration.phpโ L48-L98ใใF:includes/elementor/class-wp-mcp-ai-elementor-chat-intro-widget.phpโ L47-L140ใใF:includes/elementor/class-wp-mcp-ai-elementor-chat-usage-timer-widget.phpโ L48-L226ใใF:includes/elementor/class-wp-mcp-ai-elementor-dashboard-activity-feed-widget.phpโ L48-L167ใ
Guest tokens are honoured by the REST endpoints through the X-WP-MCP-AI-Guest header or guest_token parameter, allowing the chat shortcode and Elementor widget to make authenticated requests on behalf of public visitors without exposing persistent credentials.ใF:includes/class-wp-mcp-ai-rest.phpโ L289-L307ใใF:includes/class-wp-mcp-ai-rest.phpโ L2088-L2104ใ
Chat History Persistence
The chat interface automatically persists conversation history to the browser's localStorage, preventing data loss when users navigate away or refresh the page. Conversations are:
Automatically saved after each user message and assistant response
Automatically restored when returning to the chat page (within 24 hours)
Stored per assistant so different assistant conversations remain separate
Server-side storage available with JetEngine - See note below about optional JetEngine integration
Server-Side Chat Transcript Storage (Requires JetEngine)
โ ๏ธ Third-Party Plugin Required: JetEngine (not included with NV oOS)
Without JetEngine, chat conversations are only stored in browser localStorage (client-side, 24-hour retention). To enable permanent server-side chat transcript archiving:
Install and activate the JetEngine plugin (third-party, paid plugin from Crocoblock)
Enable the Custom Content Types module in JetEngine settings
NV oOS will automatically provision the
ai_chat_transcriptsCCT for permanent storage
What you get with JetEngine:
โ Permanent server-side chat transcript storage
โ Cross-device conversation access
โ Admin visibility into chat history
โ Database-backed chat logs for compliance/auditing
Without JetEngine:
โ ๏ธ Chat history only stored in browser localStorage
โ ๏ธ Limited to 24-hour retention
โ ๏ธ No cross-device synchronization
โ ๏ธ Lost if browser data is cleared
See docs/user-guides/chat/chat-history-persistence.md for complete details on the persistence mechanism, data structure, and troubleshooting.
๐ฆ Installation
โน๏ธ Plugin Directory Status
This plugin is currently pending approval in the WordPress Plugin Directory. We are committed to maintaining high quality and security standards throughout the review process. You can install the plugin manually from our GitHub repository or wait for the official WordPress Plugin Directory listing.
๐ Getting Started Wizard
After activating the plugin, you'll be redirected to a 4-step setup wizard that walks you through connecting an AI provider, choosing a use case, and creating your first assistant โ all in under 2 minutes. The wizard creates fully-configured assistants with tools, system prompts, and tuned temperatures so your site is working out of the box. You can access the wizard any time at NV oOS โ Getting Started or directly at/wp-admin/admin.php?page=wp-mcp-ai-getting-started.
๐ฑ Beginner 3-Step Install (Try it on Your PC)
No live site. No API costs. No risk. The fastest way to try NV oOS is on your own computer using a free local WordPress environment. Follow the full walkthrough on the NV Digital Solutions blog: How to Test NV oOS on Your Own PC Using Local + Downloading the Plugin โ
Install a local WordPress environment โ Local by WP Engine or WordPress Studio is the easiest option (one-click install, no server config). Alternatives: XAMPP, MAMP, or DevKinsta.
Download the NV oOS plugin zip โ grab the latest release from GitHub Releases (look for
mcp-ai-wpoos-x.x.x.zip), or use the Code โ Download ZIP button for the current development snapshot.Upload, activate, and run the wizard โ in your local WordPress dashboard go to Plugins โ Add New โ Upload Plugin, select the zip, activate it, and follow the ๐ Getting Started Wizard. For a free local AI model (no API key needed), install LM Studio and point the wizard at
http://localhost:1234.
๐บ Single-file auto-installer (roadmap) โ A single cross-platform installer that bootstraps the entire stack automatically is on the roadmap. See the App / Plugin Distribution Proposal for current status and the plan.
Requirements
Minimum Requirements:
WordPress 6.0+
PHP 7.4+ (PHP 8.0+ recommended)
MySQL 5.7+ or MariaDB 10.3+
Optional Requirements for Enhanced Features:
Node.js 14+: Required for image vectorization tools (
vectorize_imagetool)PHP Functions:
proc_open,proc_close,proc_terminate(for Node.js integration and Process Service)These functions are often disabled on shared hosting for security
Can be enabled on Cloudways via Application Settings (see troubleshooting guide)
JetEngine Plugin: For CCT storage and advanced content management tools
WooCommerce: For e-commerce integration tools
Elementor: For visual page builder widgets
Note: The plugin works without optional requirements, but some features will be disabled. See deployment troubleshooting for enabling disabled PHP functions.
For Developers (GitHub Clone)
โ Production-Ready Repository
This repository includes production-optimized vendor dependencies with classmap-authoritative autoloading configured by default in composer.json. You can clone and activate immediately without running composer. Thecomposer installcommand is only needed if you want to update dependencies or add development tools.
โก Use a shallow clone
A full clone of this repository is ~10 GB due to its long history. Use--depth 1to download only the latest snapshot (~500 MB) โ much faster and smaller. If you later need the full history, rungit fetch --unshallow.git clone --depth 1 https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git
If you're cloning from GitHub:
Option 1: Cloudways and Managed Hosting (Recommended)
For Cloudways and similar managed hosting platforms, clone directly into the WordPress plugins directory:
# SSH into your server
# Navigate to WordPress plugins directory
cd /home/master/applications/YOURAPP/public_html/wp-content/plugins/
# Clone the repository (production-ready, no composer needed!)
# Use --depth 1 for a fast shallow clone (recommended for production)
git clone --depth 1 https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git
cd mcp-ai-wpoos
# Verify you're in the correct directory
pwd # Should show the plugins path
# Optional: Only needed for frontend asset rebuilding or development
# npm install && npm run build
# Optional: Only run if you need to update dependencies or add dev tools
# Note: Autoloader optimization is now configured by default in composer.json
# composer install --no-devโ ๏ธ Cloudways Important Notes:
Always clone directly into
/home/master/applications/YOURAPP/public_html/wp-content/plugins/Do NOT clone elsewhere and then move/copy - this causes
getcwd() failederrorsReplace
YOURAPPwith your actual Cloudways application name
Option 2: Local Development or VPS
For local development or standard VPS hosting:
# Option A: Clone directly into WordPress plugins directory (recommended, production-ready!)
cd /path/to/wordpress/wp-content/plugins/
# Use --depth 1 for a fast shallow clone (recommended for production)
git clone --depth 1 https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git
cd mcp-ai-wpoos
# Ready to activate! No composer or npm needed for production use.
# Option B: Clone and copy (also production-ready!)
# Use --depth 1 for a fast shallow clone (recommended for production)
git clone --depth 1 https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git
cd mcp-ai-wpoos
cp -r . /path/to/wordpress/wp-content/plugins/mcp-ai-wpoos/For Development Only:
# Only if you need to rebuild assets or modify dependencies:
npm install && npm run build
# Note: Autoloader optimization is now configured by default in composer.json
composer install --no-devOptional: Strip Dev Files for Production
If you are deploying via git clone to a production server with anti-malware / EDR scanning, the working tree will contain test fixtures that embed verbatim attack-payload literals (XSS canaries, SQL-injection samples, prompt-injection strings) used by the security test suite. These can occasionally trip signature-based scanners.
For a clean production tree, run the bundled strip script after cloning:
# Preview what would be removed
bin/strip-dev-files.sh --dry-run
# Remove tests/, docs/, bin/, .github/, .bmad/, .context/, examples/,
# phpunit.xml.dist, phpcs.xml.dist, dev configs, etc.
bin/strip-dev-files.shThe script mirrors the exclusion list in .distignore (used for the WordPress.org SVN deploy) and the export-ignore rules in .gitattributes (used for GitHub-distributed ZIPs). It is idempotent and refuses to run on a working tree with uncommitted changes (override with --force).
Note: Do not run this on a development checkout โ it removes the test suite, docs, and build tooling. It is intended for deploy targets that only run the plugin.
Final Steps
Activate Open Operator System Complete (NV oOS) from WordPress admin
You now have the complete version with all ~1,566 tools (~303 base + ~1,263 Pro; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative)
What you get from the repository clone:
โ The full codebase โ all ~1,566 built-in tools ready to use (~303 base + ~1,263 Pro; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative)โ Single plugin activation (not separate base + pro)
โ Pro features automatically available (no separate Pro plugin to install)
Notes:
The repository includes
mcp-ai-wpoos-base.phpandaddons/pro/mcp-ai-wpoos-pro.phpwhich are used for building separate distributions but do NOT appear as separate plugins when cloningOnly the main plugin file (
mcp-ai-wpoos.php) has a plugin header in the repositoryThe build script adds headers to the other files when creating standalone distributions
Standard Installation
Upload
mcp-ai-wpoos.zipto/wp-content/plugins/Activate NV oOS from the WordPress admin
Go to Settings โ NV oOS
Enter your OpenAI API key
Create a new โAI Assistantโ in AI Assistants
Add
[mcp_ai_chat assistant="123"]to a page or post
Optional: JetEngine Integration
โ ๏ธ Third-Party Plugin (Not Included): JetEngine is a paid plugin from Crocoblock
JetEngine is completely optional - NV oOS works perfectly without it. However, if you want server-side chat transcript storage:
Purchase and install JetEngine separately
Enable the Custom Content Types module in JetEngine settings
NV oOS will automatically provision the
ai_chat_transcriptsCCT for permanent chat storage
What works WITHOUT JetEngine:
โ All core AI assistant features
โ Chat interface and conversations
โ ~300 base tools (more with optional third-party plugins)
โ MCP server functionality (
/wp-json/mcp-ai/v1/)โ Browser-based chat history (localStorage, 24 hours)
โ OpenAI/Gemini/Anthropic/Ollama/Hugging Face/Cloudflare integrations
What requires JetEngine:
โ Server-side chat transcript storage (chat history only in browser without it)
โ 5 JetEngine-specific tools (see ๐ Optional Tools & Dependencies)
๐ What You Lose Without Third-Party Plugins
NV oOS works perfectly with vanilla WordPress, but certain features require third-party plugins (sold separately). Here's exactly what you lose without each plugin:
Without JetEngine (Crocoblock - Paid Plugin)
Lost Features:
โ AI metaboxes for JetEngine CPTs/Taxonomies - No AI assistant integration on JetEngine edit screens
โ Research & Add pages - No AI-powered content creation with automatic field mapping
โ Server-side chat transcript storage - Chat history only stored in browser localStorage (24 hours)
โ Cross-device chat synchronization - No database-backed conversation history
โ Admin chat history access - Cannot view/audit conversations from admin panel
โ Assistant CCT synchronization - Assistants only in WordPress CPT (MCP server still works perfectly)
Lost Tools (5 tools):
get_jetengine_items- Query JetEngine custom post typeslist_jetengine_rest_routes- List JetEngine REST API routesinvoke_jetengine_route- Execute JetEngine REST operationsget_jetformbuilder_forms- List JetFormBuilder forms (also requires JetFormBuilder)get_jetformbuilder_submissions- Get form submissions (also requires JetFormBuilder)
โ Still Works: All core features, MCP server, ~300 base tools, AI conversations
Without WooCommerce (Free Plugin)
Lost Features:
โ E-commerce automation - Cannot create or manage products via AI
โ Order management - Cannot query or analyze orders
โ Product catalog access - Cannot search or update product data
Lost Tools (3 tools):
create_woo_product- Build draft WooCommerce products with AI-generated descriptions, pricing, and imagesget_woo_products- Search and retrieve product catalog with pricing and stock statusget_woo_recent_orders- Summarize recent orders with billing details and totals
Use Cases Lost: E-commerce content generation, order fulfillment assistance, product merchandising
Without Elementor (Freemium Plugin)
Lost Features:
โ Template management - Cannot list or reference Elementor templates via AI
โ Elementor widgets - Cannot use pre-built chat/dashboard widgets (shortcodes still work)
Lost Tools (2 tools):
get_elementor_templates- List Elementor library templates with status, type, and edit linksimport_elementor_template_kit- Import Elementor template kits
Lost UI Components:
Elementor Chat Widget
Elementor Chat Intro Widget
Elementor Dashboard Widgets (Tool Matrix, User Capabilities, Activity Feed, etc.)
โ
Still Works: Standard [mcp_ai_chat] shortcode, all AI features
Without Rank Math SEO (Freemium Plugin)
Lost Features:
โ SEO analysis - Cannot query SEO scores or optimization recommendations
โ Schema data access - Cannot retrieve structured data for posts
Lost Tools (1 tool):
get_rankmath_seo- Get SEO scores, focus keywords, robots metadata, and schema details for posts
Use Cases Lost: AI-powered SEO content optimization, SEO audit assistance
Without WPCode (Freemium Plugin)
Lost Features:
โ Code snippet management - Cannot create or update code snippets via AI
โ Custom functionality automation - Cannot automate adding hooks, filters, or custom code
Lost Tools (1 tool):
create_wpcode_snippet- Create or update code snippets with validation and activation control
Use Cases Lost: AI-assisted custom development, automated code snippet generation
Without Simple JWT Login (Free Plugin)
Lost Features:
โ JWT token generation - Cannot generate JWT bearer tokens for headless WordPress integrations
Lost Tools (1 tool):
generate_simple_jwt_token- Generate JWT bearer tokens for authenticated API access
Use Cases Lost: Headless WordPress authentication, mobile app integration, SPA authentication
Summary: Third-Party Plugin Dependencies
Plugin | Type | Tools Lost | Key Feature Lost |
JetEngine | Paid (Crocoblock) | 5 | Server-side chat transcript storage |
WooCommerce | Free | 3 | E-commerce automation |
Freemium | 2 + Widgets | Elementor template integration | |
Rank Math | Freemium | 1 | SEO analysis |
WPCode | Freemium | 1 | Code snippet management |
Simple JWT Login | Free | 1 | JWT token generation |
Total Impact: Without these plugins, you lose 13 tools but retain ~300 base tools and all essential AI assistant functionality.
Base Version (Default)
NV oOS runs in Base Version mode by default, providing ~300 essential tools that work with vanilla WordPress without requiring any third-party plugins:
Base Version includes ~300 essential tools that work with vanilla WordPress:
Content management (search, save posts, attachments)
AI media generation (images via OpenAI/Gemini, speech, transcription, video)
Research tools (web search, weather, disaster alerts)
Site operations (health checks, logs, cron jobs, cache management)
WordPress-native email (via wp_mail)
Image manipulation (resize, crop, rotate, convert, vectorize to SVG)
Graphic editing (local operations and AI-powered transformations)
Profession and assistant management
GitHub integration tools
Google Maps Platform tools
Base Version excludes 31 tools requiring third-party plugins or external APIs:
Third-party WordPress plugins (13 tools) - See ๐ What You Lose Without Third-Party Plugins for details
WooCommerce tools (3)
JetEngine/JetFormBuilder tools (5)
Elementor tools (2)
RankMath/WPCode/Simple JWT Login tools (3)
External API services (18 tools) - Require API credentials
Google services (5)
Social media integrations (8)
External messaging services (4)
QuickBooks (1)
Full Version Installation (Opt-in)
To enable the Full Version with all third-party integrations and external API tools, add this constant to your wp-config.php file:
define( 'WP_MCP_AI_BASE_VERSION', false );๐ See BASE-VERSION.md for the complete tool list and customization options.
When to use Base Version:
Starting fresh with WordPress
Testing or development environments
Simpler installations without external dependencies
Sites that don't need e-commerce or advanced integrations
Don't want to purchase/install third-party plugins
When to use Full Version:
Production sites with WooCommerce, JetEngine, or Elementor already installed
Sites needing social media automation (requires API credentials)
Advanced workflows requiring external APIs
Need server-side chat transcript storage (requires JetEngine)
๐ See detailed breakdown: ๐ What You Lose Without Third-Party Plugins
๐ Documentation
NV oOS includes comprehensive documentation covering all aspects of the plugin. Documentation reorganized June 2026 โ Unix-theory separation of concerns. All docs sorted into 12 purpose-driven directories with zero content loss.
๐ Documentation Hub
Documentation Hub โญ Start here - Central navigation with organized categories
Documentation Index - Complete map of all 1,600+ documentation files
Architecture Overview - System architecture (15 providers, ~1,566 tool classes, 36 REST controllers)
Request Flow Walkthrough - End-to-end chat request lifecycle trace
Quick Reference Guide - Fast access to common tasks and commands
Essential References
Tool Reference - All ~1,566 tools documented (~303 base + ~1,263 Pro; live count via
WP_MCP_AI_Tool_Registry::get_tools()is authoritative)REST API Documentation - Complete API reference with examples
Testing & Quality Report - Test results and code quality analysis
๐ฆ Archive
Historical Documentation โ 50+ archived files from 2024-2025 development
Docs Archive - Consolidated implementation history and superseded documentation
For New Users
๐ Getting Started Wizard โญ NEW โ 4-step guided setup that connects your AI provider, selects a use case, and creates a ready-to-use assistant in under 2 minutes. 8 presets available: Content Creator, Customer Support, E-commerce, SEO & Research, Developer Copilot, Media & Creative Studio, Site Administrator, General Purpose.
Use Cases & Quickstart Guides โญ NEW - Comprehensive guide covering 7 major use cases with step-by-step quickstarts
5-Minute Quick Start - Get started immediately: from zero to first chat
Setup Checklist - Step-by-step installation and configuration
Remote Client Quickstart - Connect Claude Desktop, LM Studio, or other MCP clients
Best Practices - Recommended usage patterns and optimization tips
For Developers
Testing & Quality Report - Test suite results (2,106 tests, 73.4% pass rate), code quality analysis, security audit
Code Review Master - Comprehensive code quality analysis (95/100 score)
Action Items - Prioritized development tasks (180+ hours)
Authentication Guide - Authentication methods and security
MCP JSON-RPC 2.0 Endpoint - Model Context Protocol implementation
For Administrators
Deployment Troubleshooting - Common issues and solutions
Multisite Support - WordPress multisite configuration
Rate Limit Protection - API rate limiting setup
Mesh Routing Guide - Intelligent compute routing across sites and providers
Federation & Discovery - Decentralized AI capability network with peer discovery and well-known endpoints
Performance & Optimization
Message Bundling - Client-side message optimization
High Token Tool Handling - Agentic loop token management
Job Notification System - Real-time async job updates
Chat Performance Optimizations - Complete performance guide
Mesh Routing Guide - Intelligent compute routing across sites and providers
Historical Documentation
Archive Directory - 95+ historical documents organized by category:
implementations/- Implementation summaries and technical detailsphases/- Development phase documentsfixes/- Bug fix summaries and issue resolutionsfeatures/- Feature documentationcode-reviews/- Code review reportstesting/- Test infrastructure documentation
โ๏ธ Configuration Checklist (Action Items)
Complete these after installation to unlock every integration point:
Add your OpenAI API key in Settings โ NV oOS โ OpenAI API Key so API calls are authorised.
Add your Gemini API key in Settings โ NV oOS โ Gemini API Key if you plan to route assistants through Gemini.
Confirm or override the default model via Settings โ NV oOS โ Default Model (
gpt-4.1ships as the default).Set a default Gemini model under Settings โ NV oOS โ Default Gemini Model when Gemini is enabled.
Choose the default provider from Settings โ NV oOS โ Default Provider so new assistants know whether to use OpenAI or Gemini by default.
Adjust the request timeout under Settings โ NV oOS โ Request Timeout (minimum 5โฏs, default 30โฏs) to match your hosting environment.
Select a default assistant with Settings โ NV oOS โ Default Assistant so REST and shortcode requests have a fallback.
Decide on logging with Settings โ NV oOS โ Enable Logging when you need verbose diagnostics.
Monitor token usage in Settings โ NV oOS โ Token Usage Statistics to track API consumption across users, providers, and models for billing and budget management.
Choose your uninstall behaviour via Settings โ NV oOS โ Remove Data on Uninstall if this site should purge assistants and settings during cleanup.
Configure Crawl4AI access in Settings โ NV oOS โ Tools when you want the Crawl4AI tool to be available to assistants.
Review attachment MIME overrides in Settings โ NV oOS โ Attachments before enabling file uploads for end users.
Review Send Group Email permissions in Settings โ NV oOS โ Tools to choose the capability and recipient cap for the group email automation.ใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L348-L359ใใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L938-L953ใ
Connect Gmail under Settings โ NV oOS โ Tools โ Connections โ Gmail to enable Gmail search tools with OAuth 2.0. See Google OAuth Setup Guide for complete configuration steps.
Connect QuickBooks Online under Settings โ NV oOS โ QuickBooks Company ID / API Key so the bundled reporting tool can fetch finance statements for authorised operators.ใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L906-L955ใ
Configure Mailjet credentials in Settings โ NV oOS โ Mailjet API Key / Secret / From Email / From Name before enabling Mailjet-powered tools or Elementor widgets that send email on behalf of assistants.ใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L1008-L1054ใ
Enable Federation & Discovery (Optional) in Settings โ NV oOS โ Federation & Discovery to publish your site's AI capabilities via
/.well-known/ai-peerand optionally run a directory service for peer discovery. Configure regions, data tags, and rate limits to control how your site participates in the decentralized AI network.ใF:docs/features/federation/federation-discovery.mdโ L1-L511ใใF:FEDERATION-IMPLEMENTATION-SUMMARY.mdโ L1-L381ใConfigure Root Security Key (Optional) by adding
define( 'WP_MCP_AI_ROOT_SECURITY_KEY', 'your-secure-key' );to wp-config.php. This provides an additional security layer that can be enabled during emergency shutdown to require authentication before re-initializing the plugin.ใF:docs/features/security/root-security-key.mdโ L1-L511ใEnable Pro Dashboard (Optional) by adding
define( 'WP_MCP_AI_PRO_DASHBOARD_ENABLED', true );to wp-config.php. This activates the dedicated Pro Dashboard with ISO/IEC 27001 compliance monitoring, reporting, and management tools. See Pro Dashboard Documentation for details.
๐ง Language Model Providers (OpenAI, Gemini, Anthropic, Baseten, DeepSeek, OpenRouter, Kimi, DigitalOcean, NVIDIA NIM, Ollama, LM Studio, Hugging Face, Cloudflare)
A dedicated router transparently forwards chat completions to the active provider, allowing each request to target OpenAI, Gemini, Anthropic, DeepSeek, OpenRouter, Baseten, Kimi, DigitalOcean, NVIDIA NIM, a local Ollama instance, LM Studio, Hugging Face, or Cloudflare Worker AI while sharing the same assistant UX.ใF:includes/class-wp-mcp-ai-language-model-router.phpโ L12-L86ใ Configure the required API keys, default models, and the global default provider in Settings โ NV oOS so new assistants inherit sensible defaults and administrators can switch providers without code changes.ใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L124-L333ใใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L505-L530ใ Assistants can still override provider, model, and generation parameters on a per-post basis.
Privacy & Terms: All AI providers have specific terms and privacy policies:
Ollama/LM Studio: Self-hosted (no external data transmission)
LM Studio Support
LM Studio with Function Calling - Full support for OpenAI-compatible function calling with local LM Studio instances:
OpenAI-compatible message structure preserved for tool calls
Tools/functions can be invoked by LM Studio models (e.g., qwen/qwen3-coder-30b)
Streaming automatically disabled when tools are present for reliable execution
Full backward compatibility with non-tool scenarios
Connect via JSON-RPC endpoint (recommended) or SSE streaming
See LM Studio setup guide for configuration details
Provider Priority List & Automatic Fallback
The plugin includes an intelligent provider priority system that automatically tries alternative providers when the primary one fails or is unavailable. In Settings โ NV oOS, you can:
Drag and drop providers to set your preferred order
Automatic fallback - if the first provider fails, the system tries the next one
Visual management - see all available providers (OpenAI, Gemini, Anthropic, Baseten, DeepSeek, OpenRouter, Kimi, DigitalOcean, NVIDIA NIM, Ollama, LM Studio, Hugging Face, Cloudflare) in one sortable list
Flexible prioritization - adjust based on cost, performance, or availability needs
The first provider in the list serves as the default. If any provider returns an error, the router automatically attempts the next provider in the list until one succeeds. This ensures maximum uptime and resilience without manual intervention. All fallback attempts are logged for debugging and monitoring.
Local AI with Ollama
The Ollama provider enables privacy-focused, cost-free AI processing by connecting to a local Ollama or LM Studio instance running on your server or development machine. This is ideal for:
Privacy-sensitive deployments where data must stay on-premises
Development and testing without incurring API costs
Custom or fine-tuned models not available through cloud providers
Air-gapped environments without internet access
To configure Ollama:
Install Ollama on your server or local machine
Pull a model (e.g.,
ollama pull llama2)Navigate to Settings โ NV oOS โ Ollama Configuration
Enter your Ollama endpoint URL (default:
http://localhost:11434)Click "Test Connection" to verify connectivity
Click "Fetch Models" to see available models
Select a model from the list or manually enter a model name
Set "Default Provider" to "Ollama (Local AI)" if you want it as the system default
The Ollama client supports the standard chat completion flow and automatically normalizes responses to match the OpenAI format for downstream compatibility. Note that some advanced features like tool calling may vary depending on the specific Ollama model you're using.
OpenAI model coverage
The plugin ships with presets for OpenAIโs current Responses, Reasoning, Audio, and Image APIs so site owners can choose the right model for each workflow. Token windows describe the maximum request size (messages, attachments, and tool payloads) the OpenAI API will accept for that model, while output limits reflect the largest single response the service will stream back. Leave a safety margin below each ceiling so assistants can add system instructions, tool calls, and knowledge snippets without hitting provider limits.
Capability | Model | Max context tokens | Max output tokens | Notes |
Responses (flagship) |
| 400,000 | 128,000 | Latest flagship multimodal model with 400K context window (Dec 2025). Ideal for large documents and complex workflows. |
Responses (pro reasoning) |
| 400,000 | 128,000 | Advanced reasoning variant with enhanced capabilities for mission-critical tasks requiring maximum accuracy. |
Responses (high throughput) |
| 400,000 | 128,000 | High-volume optimized variant for customer support and content generation at scale. |
Responses (deep analysis) |
| 400,000 | 128,000 | Deeper analysis variant with reasoning time dial for multi-step analysis and research tasks. |
Responses (general) |
| 128,000 | 16,384 | Flagship multimodal model that balances quality and latency for production chat, tool, and multimodal calls. |
Responses (cost optimised) |
| 128,000 | 16,384 | Budget-friendly 4.1 variant recommended for day-to-day assistants and background automations. |
Responses (advanced) |
| 128,000 | 16,384 | Previous generation multimodal model with strong reasoning capabilities. |
Responses (legacy) |
| 128,000 | 16,384 | Lower-latency 4o tier that keeps the larger context window while reducing cost for iterative workflows. |
Reasoning |
| 128,000 | 32,768 | Deliberate reasoning model suited to multi-step planning and analysis; expect slower responses while it โthinksโ. |
Reasoning (fast) |
| 128,000 | 32,768 | Lighter o1 variant that trades some reasoning depth for responsiveness in operational assistants. |
Media and multimodal defaults
Capability | Model | Size or duration limits | Notes |
Image generation |
| Up to 2048ร2048 output (square) or 2048ร1152 / 1152ร2048 (16:9 / 9:16) for |
|
Text-to-speech |
| Up to ~4,096 input tokens per request | Generates natural-sounding speech in multiple voices; longer scripts should be chunked into multiple calls. |
Speech-to-text |
| Optimised for recordings โค 90 minutes | Handles multilingual transcription and translation; large files are automatically chunked client-side before upload. |
OpenAI regularly revises token policies and media limits, so review the model specification dashboard before rolling out new assistants or increasing attachment budgets. Updating your defaults in Settings โ NV oOS keeps every assistant aligned with the latest provider guidance.ใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L36-L105ใใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L2298-L2398ใ
๐งฑ ChatKit Integration
The ChatKit module now ships with the core NV oOS plugin, so no separate add-on installation is required. Once enabled it self-registers through ChatKitโs filter and action APIs as soon as both plugins load, exposing the mcp-ai/v1 REST namespace while advertising chat, tool invocation, attachment download, and guest token support without any manual bootstrapping. Return false from the wp_mcp_ai_chatkit_is_available filter if you need to disable the automatic registration for bespoke environments.ใF:includes/class-wp-mcp-ai-chatkit-integration.phpโ L30-L204ใใF:includes/class-wp-mcp-ai-rest.phpโ L16-L2104ใ
From the ChatKit dashboard configure the NV oOS integration and supply at least one assistant ID so ChatKit knows which conversation to join. Optional fields let you override the system prompt or preload tool shortcut payloads for operators; capability checks inherit the wp_mcp_ai_chat_capability filter, so you can align ChatKit access with the same policies used for shortcodes or REST calls.ใF:includes/class-wp-mcp-ai-chatkit-integration.phpโ L182-L210ใใF:mcp-ai-wpoos.phpโ L25-L72ใ
Consult docs/developer/integration/chatkit-integration.md for a full configuration walkthrough, JSON examples for shortcut presets, and notes on extending the definition via filters.
๐ Crawl4AI Integration
Administrators with manage_options capabilities can run the Run Crawl4AI Job tool without any external service: when no Crawl4AI endpoint is configured the plugin performs the crawl directly on the WordPress server using the built-in HTTP client, extracts headings and text as Markdown, and records the raw HTML and response metadata for the assistant.ใF:includes/tools/class-wp-mcp-ai-tool-run-crawl4ai-job.phpโ L32-L745ใ Errors for individual URLs are captured in the response metadata so partial crawls still return useful context. When a remote Crawl4AI endpoint is configured the request now returns immediately with a task token while WP-Cron powered background polling captures the final payload and makes it available to the assistant UI once the crawl finishes.ใF:includes/crawler/class-wp-mcp-ai-crawler.phpโ L1-L214ใใF:assets/js/chat.jsโ L1-L2200ใ
Configure remote endpoints or API keys under Settings โ NV oOS โ Tools to tailor how the Crawl4AI integration runs across environments.ใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L248-L521ใ
Supplying a Crawl4AI base URL (and optional API key) switches the tool back to proxying crawl jobs to the remote Crawl4AI REST API, preserving backwards compatibility with existing deployments.ใF:includes/tools/class-wp-mcp-ai-tool-run-crawl4ai-job.phpโ L206-L339ใใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L248-L521ใ Local environments can still feed a custom endpoint to the integration through the WP_MCP_AI_CRAWL4AI_BASE_URL or CRAWL4AI_BASE_URL environment variable when you want to test against a dedicated Crawl4AI service.ใF:mcp-ai-wpoos.phpโ L54-L96ใ
๐ก Job Notification System
NV oOS includes a general-purpose infrastructure for real-time notifications on async WordPress jobs, providing SSE streaming and webhook support for external integrations.ใF:docs/features/async-jobs/job-notification-system.mdโ L1-L100ใ
Architecture
Async Job โ WordPress Action โ Job Notifier โ [SSE | Webhooks]
โ โ
Frontend ExternalAutomatic Crawl4AI Integration
The system automatically hooks into Crawl4AI jobs via the wp_mcp_ai_crawl4ai_job_completed action, providing real-time status updates as crawls progress. No additional code is neededโCrawl4AI jobs automatically trigger notifications.ใF:includes/crawler/class-wp-mcp-ai-crawler.phpโ L1-L214ใ
Frontend SSE Subscription
JavaScript clients can subscribe to job status updates using Server-Sent Events:
const jobId = 'crawl_abc123';
const eventSource = new EventSource(
`/wp-json/mcp-ai/v1/jobs/${jobId}/stream?max_duration=300&poll_interval=2`
);
eventSource.addEventListener('status', (e) => {
const status = JSON.parse(e.data);
console.log('Job status:', status.status, status.progress);
updateProgressBar(status.progress);
});
eventSource.addEventListener('complete', (e) => {
const data = JSON.parse(e.data);
console.log('Job completed:', data.final_status);
eventSource.close();
});Webhook Registration
External systems can receive HTTP callbacks when jobs complete:
WP_MCP_AI_Job_Notifier::register_webhook(
'crawl_abc123',
'https://example.com/webhook',
array( 'completed', 'failed' )
);โก๏ธ See docs/features/async-jobs/job-notification-system.md for complete implementation details.
๐ง Elementor Widgets
Sites running Elementor automatically register a suite of MCP blocks so you can assemble onboarding pages, operational dashboards, and standalone chat layouts without writing markup.ใF:includes/class-wp-mcp-ai-elementor-integration.phpโ L12-L98ใ The integration only boots when Elementor is present, so non-Elementor installs avoid any overhead.ใF:includes/class-wp-mcp-ai-elementor-integration.phpโ L29-L46ใ
Chat surfaces and companion blocks
NV oOS Chat โ Renders the assistant interface with the same controls exposed by the
[mcp_ai_chat]shortcode, including theallow_gueststoggle for minting temporary visitor tokens.ใF:includes/elementor/class-wp-mcp-ai-elementor-widget.phpโ L17-L138ใNV oOS Chat Bubble โญ NEW โ Floating chat bubble that sits at a configurable screen corner and opens a chat panel powered by the existing
[mcp_ai_chat]shortcode. Also available as a Gutenberg block (wp:mcp-ai-wpoos/chat-bubble). 5 control sections: Chat Settings, Bubble Settings (position/size/animation/tooltip/badge/auto-open), Panel Settings, Bubble Style, Panel Style. BEM CSS with 4 positions, 3 sizes, bounce/pulse animations, dark mode, full-screen mobile (<480px),prefers-reduced-motion, WCAG focus states. Public API atwindow.wpMcpAiChatBubble.ใF:includes/elementor/class-wp-mcp-ai-elementor-chat-bubble-widget.phpโ L1-L200ใใF:includes/blocks/chat-bubble/block.jsonโ L1-L50ใNV oOS Chat Intro โ Adds a configurable hero block above the conversation with headings, talking points, and an optional call-to-action button to guide visitors before they engage the model.ใF:includes/elementor/class-wp-mcp-ai-elementor-chat-intro-widget.phpโ L47-L190ใ
NV oOS Chat FAQ โ Surfaces a repeater-driven FAQ list alongside the chat so product teams can document policies and best practices in context.ใF:includes/elementor/class-wp-mcp-ai-elementor-chat-faq-widget.phpโ L47-L150ใ
NV oOS Usage & Timer โ Combines a focus timer with per-user token totals, gracefully handling logged-out visitors, disabled tracking, and empty usage histories.ใF:includes/elementor/class-wp-mcp-ai-elementor-chat-usage-timer-widget.phpโ L48-L340ใ
Operations dashboards
NV oOS Tool Matrix โ Pulls the tool registry, groups integrations by focus area, and highlights the required capability for each assistant tool so administrators can plan enablement safely. The Send Group Email row now mirrors the capability and recipient limit configured in the MCP settings so editorial policies stay front-of-mind.ใF:includes/elementor/class-wp-mcp-ai-elementor-dashboard-tool-matrix-widget.phpโ L48-L440ใ
NV oOS User Capability Snapshot โ Summarises the signed-in operatorโs profile, common capabilities, JetEngine access, and multisite memberships to support governance reviews. It also surfaces the configured Send Group Email capability and limit so administrators immediately know whether the current user can trigger bulk mail jobs.ใF:includes/elementor/class-wp-mcp-ai-elementor-dashboard-user-capability-widget.phpโ L48-L392ใ
NV oOS Theme Preview โ Renders a mock conversation using the saved chat color tokens and optionally displays a legend of every branding token for quick QA during rollouts.ใF:includes/elementor/class-wp-mcp-ai-elementor-dashboard-theme-preview-widget.phpโ L48-L198ใ
NV oOS Provider Quick Links โ Reuses the OpenAI usage/log tools to populate external billing and telemetry shortcuts that open in new tabs for rapid debugging.ใF:includes/elementor/class-wp-mcp-ai-elementor-dashboard-provider-links-widget.phpโ L48-L166ใ
NV oOS Activity Feed โ Streams the latest MCP log entries (tool runs, chat interactions, and optional provider requests), collapsing raw context into expandable JSON blocks for deeper analysis.ใF:includes/elementor/class-wp-mcp-ai-elementor-dashboard-activity-feed-widget.phpโ L48-L210ใ
๐งฎ Usage Tracking
Privacy-First Analytics (v1.2.0+)
The plugin includes optional, privacy-first activation tracking to help us understand plugin usage and improve development priorities. This feature is:
Privacy Features:
โ No PII collected - No personal information or identifiable data
โ Site URLs hashed - Non-reversible SHA-256 hash with WordPress salts
โ No IP storage - IP addresses are not logged or stored
โ Local dev excluded - Automatically disabled for localhost and common dev domains
โ Opt-out available - Easy to disable via settings or filter hook
โ GDPR compliant - Meets all privacy regulations
โ Fully transparent - All code is open source and documented
Data Collected:
Plugin variant (complete, base, pro, or core)
Plugin version number
WordPress version
PHP version
Site locale (language)
Multisite status
Hashed site identifier (non-reversible)
Timestamp
How to Opt Out:
Via Settings: Settings โ NV oOS โ General โ Log Management โ Disable Activation Tracking
Via Filter Hook:
add_filter( 'wp_mcp_ai_enable_usage_tracking', '__return_false' );
Full Privacy Details: See EXTERNAL_SERVICES.md for complete documentation.
The plugin records aggregate token usage per user, provider, and model whenever responses include usage metadata, simplifying internal reconciliation or billing workflows. Usage data is stored as user meta and automatically purged when accounts are deleted, and hooks are exposed for custom reporting pipelines.ใF:includes/class-wp-mcp-ai-usage-tracker.phpโ L12-L119ใ
Token Usage Management Dashboard
Administrators with manage_options capability can view comprehensive token usage statistics in Settings โ NV oOS:
Global Statistics (All Users):
Total requests across all users
Total tokens consumed (prompt + completion)
Prompt tokens used
Completion tokens generated
Cached tokens (for providers supporting prompt caching)
Reset all usage data button (with confirmation)
Individual User Statistics:
Your personal token consumption
Per-user breakdown of requests and tokens
Reset personal usage data button
Detailed Breakdown:
Usage by provider (OpenAI, Gemini, Anthropic, NVIDIA NIM, Ollama, LM Studio, Hugging Face, Cloudflare)
Usage by specific model (e.g.,
gpt-4.1-mini,gemini-2.0-flash)Request counts per provider/model combination
Last used timestamp for each model
Comprehensive table view with all metrics
The usage tracking system automatically:
Records usage from all API responses that include usage metadata
Aggregates data by user, provider, and model
Updates in real-time as conversations occur
Supports the Open OpenAI Usage tool for quick access to provider dashboards
Provides AJAX-powered reset functionality for administrators
๐งท Attachment MIME Controls
Administrators can override the default image and file MIME allowlists used by the chat uploader. The settings screen accepts one MIME type per line, and the attachment helper merges the overrides with its defaults before enforcing them on upload and shortcode configuration.ใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L225-L669ใใF:includes/class-wp-mcp-ai-message-attachments.phpโ L503-L559ใ Leave the fields empty to fall back to the bundled safe defaults.
โก Message Bundling
NV oOS implements client-side message bundling to optimize API usage and reduce server load. When enabled, messages sent within an 800ms window are automatically grouped into a single API request, reducing costs and improving performance for users who send multiple messages in quick succession.ใF:docs/user-guides/chat/message-bundling-feature.mdโ L1-L80ใ
How It Works
User sends a message โ Displayed immediately in the chat UI
800ms timer starts โ System waits for additional messages
More messages arrive โ Timer resets with each new message
Timer expires โ All queued messages sent together in one request
Visual Feedback
"Preparing to sendโฆ" - Messages are being queued during the bundling window
"Sendingโฆ" - Bundled messages are being transmitted to the server
Benefits
Reduced API costs - Fewer requests mean lower costs for pay-per-request APIs
Lower server load - Fewer requests to process and respond to
Better mobile experience - Ideal for users who type in short bursts
Backward compatible - Server code unchanged, same payload format
Configuration
Message bundling is enabled by default and requires no configuration. To disable for debugging:
window.wpMcpAiChatDebugMode = true;โก๏ธ See docs/user-guides/chat/message-bundling-feature.md for configuration options and implementation details.
๐ฏ Agentic Loop Token Management
NV oOS includes intelligent handling for tools that return large responses, preventing token overflow errors during agentic loops (where the AI automatically calls multiple tools).ใF:docs/features/tools/presets/high-token-tool-handling.mdโ L1-L80ใ
The Problem
Tools like run_crawl4ai_job can return 100,000+ tokens of content. In agentic loops, each API call includes all previous messages, causing token counts to grow rapidly and exceed model limits (e.g., gpt-4.1-mini's 200k TPM limit).
The Solution: Three-Tier Strategy
Tier 1: Token Limit Detection
Estimates total tokens before each API call
Checks against model's TPM (Tokens Per Minute) limit
Prevents requests that would exceed limits
Tier 2: Automatic Model Switching
When limits exceeded, auto-switches to fallback model
Default fallback: Gemini 2.0 Flash (1-2 million token capacity)
Preserves full context without data loss
Transparent to the user
Tier 3: Message Truncation
If even fallback model can't handle tokens
Truncates older messages from conversation
Always preserves system prompts and recent context
Logs what was truncated for debugging
Configuration
Automatic model switching is enabled by default. Configure fallback model under Settings โ NV oOS:
// Default fallback model
'fallback_model' => 'gemini-2.0-flash-exp'โก๏ธ See docs/features/tools/presets/high-token-tool-handling.md for complete technical details and examples.
๐ Chat Performance Optimizations
NV oOS includes several performance optimizations to enhance the chat experience:
Message bundling - Reduces API calls by grouping rapid user inputs
Token budget management - Prevents API limit overruns with safety marginsใF:docs/features/performance/tpm-limit-validation.mdโ L1-L50ใ
Chat history persistence - LocalStorage (24h) + optional JetEngine CCT storageใF:docs/user-guides/chat/chat-history-persistence.mdโ L1-L50ใ
Automatic model switching - Seamlessly handles token overflow scenarios
Rate limit protection - Intelligent retry with exponential backoffใF:docs/features/performance/rate-limit-protection.mdโ L1-L50ใ
โก๏ธ See docs/features/chat/chat-performance-optimizations.md for detailed performance tuning guide.
๐ Mesh Compute Routing
NV oOS includes intelligent mesh compute routing that automatically distributes AI workload across multiple sites OR multiple providers using AI-powered decision-making. This feature works in two modes:
Multi-Site Mesh: Distribute load across multiple WordPress installations
Single-Site Multi-Provider: Balance load across OpenAI, Gemini, Anthropic, NVIDIA NIM, Hugging Face, Cloudflare, and Ollama on one site
Both modes use the same AI-powered routing engine to optimize for cost, performance, and reliability.
Key Capabilities
AI-Optimized Routing - Analyzes prompt complexity and routes to optimal provider/site
Cost Optimization - Use GPT-4o-mini for simple queries, GPT-4o for complex tasks
Automatic Failover - Switch providers on rate limits or outages
Compute Hubs - Designate powerful servers for heavy workloads
Rate Limit Management - Auto-switch to alternative providers when limits hit
Privacy Control - Route sensitive data to local Ollama instances
Quick Start Examples
Single-Site Setup (No mesh required):
Configure multiple AI providers (OpenAI + Gemini + Anthropic + Hugging Face + Cloudflare + Ollama)
Set assistant routing strategy to "AI Optimized"
Save 90% on costs by routing simple queries to cheaper models
Multi-Site Setup (Distributed compute):
Enable mesh networking on all sites
Designate compute hubs with larger models
Automatic load balancing across peer sites
Cross-server compute pooling for Cloudways, SiteGround, etc.
โก๏ธ See docs/features/federation/mesh-routing-guide.md for complete setup guide, routing strategies, and use cases. โก๏ธ See docs/features/federation/mesh-compute-pooling.md for architecture and authentication details.
๐ Federation & Discovery System
NV oOS includes a decentralized AI capability network that allows WordPress sites to publish their capabilities and discover peer sites. Think of it as "npm for AI tools" โ sites can advertise what they offer and find complementary capabilities from trusted peers.
Overview
The Federation & Discovery system provides three deployment modes:
Publisher Mode: Publish your site's capabilities via
/.well-known/ai-peerDirectory Mode: Run a discovery service for peer registration and search
Consumer Mode: Query directories to find and use peer capabilities
Quick Start
Enable Federation (Publisher Mode):
Navigate to Settings โ NV oOS โ Federation & Discovery
Check Enable federation
Configure regions (e.g.,
us, eu, ap) and data tags (e.g.,no_pii, gdpr_ok)Your capabilities are now published at
https://yoursite.com/.well-known/ai-peer
Enable Directory Service (Optional):
In the same settings section, check Enable directory service
Your directory API is now available at
https://yoursite.com/wp-json/ai-dir/v1Automatic hourly health checks verify registered peers
Key Features
๐ก Well-Known Endpoints - Standards-based capability publishing
๐ Peer Discovery - Search by capability, region, and data policy
โ Health Monitoring - Automatic cron-based peer verification
๐ Smart Ranking - Scores peers by region, latency, and policy match
๐ JWKS Verification - Built-in security with public key discovery
โ๏ธ Conditional Loading - Zero overhead when disabled
API Endpoints
Directory REST API (/wp-json/ai-dir/v1):
POST /peers/register- Register a new peerGET /peers- List all peers with health statusGET /peers/{id}- Get peer detailsGET /search- Search peers by capability/region/policyPOST /reverify/{id}- Manually trigger health checkPOST /report/{id}- Report peer issues
Well-Known Endpoints:
GET /.well-known/ai-peer- Your site's capability manifestGET /.well-known/jwks.json- Public keys for verification
Use Cases
Private Organization Network:
Multiple WordPress sites within one organization
Share AI capabilities across internal sites
Central directory for discovery
Private peer network with secure authentication
Public Directory Service:
Community-run capability discovery
Accept registrations from external sites
Provide search API for consumers
Build an ecosystem marketplace
Capability Consumer:
Query public directories for needed capabilities
Integrate with mesh router for automatic peer selection
No need to publish your own capabilities
Access specialized tools from the network
Configuration Options
Regions: Geographic locations (e.g.,
us, eu, ap, global)Data Tags: Compliance policies (e.g.,
no_pii, gdpr_ok, hipaa_like)QPS Limit: Queries per second (default: 5)
Burst Capacity: Simultaneous requests (default: 10)
โก๏ธ Complete Documentation: docs/features/federation/federation-discovery.md โก๏ธ Implementation Summary: FEDERATION-IMPLEMENTATION-SUMMARY.md
๐ต๏ธ Code Review
The 2025-10-31 internal review confirms the hardening of the group email automation (header filtering and attachment caps) and the case-sensitive variable handling in the OpenAI external action tool, and only flags a low-severity performance concern around guest token transient churn for public chat embeds. These findings have been consolidated into the master code review document. One follow-up action item recommends re-using or rate-limiting guest tokens to keep the options table tidy on cache-less hosts.
โก๏ธ See docs/developer/best-practices/CODE-REVIEW-MASTER.md for the complete code quality assessment.
๐ MCP Server Authentication
Remote MCP assistants should authenticate with Auth0-issued bearer tokens (Authorization: Bearer YOUR_TOKEN) whose audience and scope align with the values configured under Settings โ NV oOS. Same-origin experiences (the dashboard editor and shortcode UI) continue to rely on the X-WP-Nonce header tied to the logged-in WordPress session. Review docs/reference/api/mcp-server-authentication.md for a complete setup guide plus a breakdown of the structured error responses returned on failure, and keep the deployment troubleshooting checklist handy when diagnosing capability or credential regressions.
MCP transports (v1.1.55+): POST /wp-json/mcp-ai/v1/mcp speaks JSON-RPC 2.0 over Streamable HTTP by default. Legacy HTTP+SSE clients (SSE-only Accept: text/event-stream or ?stream=true) get a credential-bound session handshake from GET /mcp and receive responses as event: message on the GET stream โ enable with WP_MCP_AI_LEGACY_SSE_ENABLED. JSON-RPC errors return HTTP 200 with the {"jsonrpc","id","error"} envelope so agent SDKs that drop non-2xx bodies relay tool errors instead of hanging; auth/permission failures keep real HTTP statuses. Assistant credential headers may be sent as Authorization: Bearer cred_xxxxx.SECRET or raw Authorization: cred_xxxxx.SECRET. Tool-call traffic is governed by the settings-driven tool rate limiter (credential tokens exempt by default), and GET/HEAD discovery probes never consume the request quota. See docs/developer/implementation-plan-mcp-agent-compat.md and docs/developer/legacy-sse-transport-plan.md for the full rationale.
Using NV oOS as an MCP server
Install the plugin and create assistants. Each WordPress instance that activates NV oOS exposes an MCP-ready assistant directory backed by the
ai_assistantcustom post type, so every published assistant becomes available to remote clients once credentials are issued.ใF:includes/assistants/class-wp-mcp-ai-assistant-cpt.phpโ L460-L620ใConfigure the REST and connector settings. Populate the Auth0, model provider, and optional integration credentials under Settings โ NV oOS so the REST controller can advertise the correct namespace URLs and enforce bearer tokens per your tenant, scope, and provider defaults.ใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L36-L118ใ
Expose the MCP directory endpoints. The REST layer publishes
/assistants,/chat,/tools, and an SSE-compatible/ssehandshake inside thewp-json/mcp-ai/v1namespace, automatically scoping responses to the authenticated assistant or returning every assistant the caller may read.ใF:includes/class-wp-mcp-ai-rest.phpโ L234-L703ใ Hand-held clients can subscribe to the streaming directory event or call the JSON routes directly using the base URLs returned in the directory payload.ใF:includes/class-wp-mcp-ai-rest.phpโ L653-L703ใRegister any additional tools. Extend the serverโs capabilities by hooking into
wp_mcp_ai_register_toolsand loading custom tool classes; registered slugs flow through the assistant directory and tool execution endpoint without extra wiring.ใF:includes/class-wp-mcp-ai-tool-registry.phpโ L75-L195ใVerify the deployment before sharing credentials. Run
wp mcp-ai remote https://example.com/wp-json/mcp-ai/v1 --token=YOUR_TOKENfrom any WP-CLI environment to confirm authentication, assistant scope, and chat probes succeed before you hand tokens to operators or client teams.ใF:includes/class-wp-mcp-ai-cli-command.phpโ L137-L220ใ
Operating multiple MCP deployments
Provision a separate WordPress site (or network site) for each MCP server you need, activate NV oOS, and repeat the configuration steps above with environment-specific Auth0 audiences, scopes, and provider keys. Because the assistant directory response includes the resolved REST base and namespace metadata, MCP clients can be pointed at different deployments simply by swapping the base URL and the bearer credential minted for that siteโs assistants.ใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L48-L118ใใF:includes/class-wp-mcp-ai-rest.phpโ L653-L703ใ
Sites that enable the Simple JWT Login integration can now reuse those bearer tokens alongside Auth0 credentials. The plugin validates tokens with Simple JWT Loginโs native services, falls back to manual JWT decoding when the dependency cannot resolve a user, and automatically scopes REST requests to the assistant encoded in the token so cross-assistant hops are blocked with actionable errors.ใF:includes/class-wp-mcp-ai-simple-jwt-login-integration.phpโ L47-L214ใใF:includes/integrations/class-wp-mcp-ai-integration-simple-jwt.phpโ L240-L378ใใF:includes/class-wp-mcp-ai-rest.phpโ L2769-L2808ใ
๐ Connecting Remote MCP Clients
NV oOS works seamlessly with popular MCP clients including Claude Desktop, LM Studio, and ChatGPT connectors. Each client connects to your WordPress site via the MCP REST API at /wp-json/mcp-ai/v1 and can access assistants, execute tools, and interact with your WordPress data remotely.
SSE Support: All MCP endpoints support Server-Sent Events (SSE) for real-time streaming. Enable SSE in your client configuration for better response times and real-time updates. See the SSE Streaming Support section for details.
Quick Start
Generate an assistant credential from any published assistant's API Credentials meta box
Copy the token (format:
cred_xxxxx.SECRET) โ shown only once!Configure your MCP client with your site's base URL and the credential
Test the connection using the provided test script or WP-CLI command
Claude Desktop setup
Claude Desktop supports MCP servers through a JSON configuration file. Add your WordPress site:
{
"mcpServers": {
"wordpress-site": {
"url": "https://your-site.com/wp-json/mcp-ai/v1",
"headers": {
"Authorization": "Bearer cred_xxxxx.SECRET"
},
"sse": true
}
}
}See the complete Claude Desktop setup guide and example configurations for multi-assistant deployments.
LM Studio Setup
โ ๏ธ Having SSE content-type errors? Use the JSON-RPC endpoint instead!
LM Studio can connect using two methods:
Method 1: JSON-RPC (Recommended - No SSE)
Use this if you're getting SSE error: Invalid content type, expected "text/event-stream":
{
"servers": [
{
"id": "wordpress-mcp",
"name": "WordPress Site",
"url": "https://your-site.com/wp-json/mcp-ai/v1/mcp",
"auth": {
"type": "bearer",
"token": "cred_xxxxx.SECRET"
},
"timeout": 30000
}
]
}Configure in LM Studio:
Server Name: WordPress Site
URL:
https://your-site.com/wp-json/mcp-ai/v1/mcpAuth Type: Bearer Token
Token:
cred_xxxxx.SECRETDo NOT enable SSE
Method 2: SSE Streaming (Optional)
If you want to use SSE for real-time updates:
Base URL:
https://your-site.com/wp-json/mcp-ai/v1Enable SSE: โ (checked)
SSE Endpoint:
/sse
See the complete LM Studio setup guide and example configurations:
lmstudio-mcp-without-sse.json - Recommended
lmstudio-config.json - With SSE
ChatGPT connector setup
โ ๏ธ Note: ChatGPT connectors currently require Auth0 authentication. Assistant-issued credentials are not yet supported by OpenAI's ChatGPT platform.
To connect via ChatGPT:
Configure Auth0 in Settings โ NV oOS
Generate an Auth0 access token with the configured audience
Add the MCP server in ChatGPT's connector settings
See the ChatGPT connector guide for detailed Auth0 setup steps.
Testing your connection
Use the built-in test script to verify connectivity:
./bin/test-remote-connection.sh \
-u https://your-site.com/wp-json/mcp-ai/v1 \
-t cred_xxxxx.SECRETOr use WP-CLI:
wp mcp-ai remote https://your-site.com/wp-json/mcp-ai/v1 \
--token=cred_xxxxx.SECRETExpected output confirms the server is reachable and lists available assistants.
Complete documentation
For comprehensive setup guides, troubleshooting, and advanced configurations, see:
MCP Client Configurations โ โญ NEW: Complete guide for all MCP clients (LM Studio, Claude Desktop, Cursor, Continue.dev, Cline, OpenAI)
Remote Client Setup Guide โ Step-by-step instructions for Claude Desktop, LM Studio, and ChatGPT
MCP Server Authentication โ Authentication methods and credential management
REST API Reference โ Endpoint documentation and payload examples
Example Configurations โ Ready-to-use config files for all major MCP clients
๐ซ Token Management UI
NV oOS 1.0.0 introduces a centralized Token Manager for managing all external agent access tokens across your assistants. Access it via NV oOS โ Token Manager in the admin menu.
Features
Centralized Control - Manage all assistant credentials in one place
Security Best Practice - Tokens shown only once after creation (cannot be retrieved later)
Lifecycle Management - Create, view, revoke, and delete credentials
Audit Trail - Track who created/revoked each token and when
Metadata Display - See creation date, status (active/revoked), associated assistant
Bulk Visibility - View credentials across all assistants at a glance
How It Works
The Token Manager follows industry standards similar to GitHub Personal Access Tokens, Stripe API keys, and Auth0 credentials:
Create Token - Generate new credentials from the assistant editor
Copy Immediately - Token shown once and cannot be retrieved later
Use in MCP Clients - Configure external applications (Codex CLI, MCP clients, custom integrations)
Revoke When Needed - Disable compromised tokens without deleting audit history
Delete When Done - Permanently remove tokens and all metadata
Security Notes
Tokens are hashed before storage (only hash stored, never plaintext)
Requires
manage_optionscapabilityAll actions logged with user attribution
Revoked tokens cannot be reactivated (must create new)
HTTPS strongly recommended for token transmission
Usage Example
# In assistant editor: Create credential โ Copy token immediately
# Token format: cred_[YOUR_PREFIX].[YOUR_SECRET_KEY_HERE]
# Example format only - never share real tokens!
# Configure MCP client (e.g., Codex CLI)
export WPOOS_BEARER_TOKEN="your_token_here"
codex chat --assistant 123 "Hello world"
# Later: Revoke from Token Manager UI if compromised
# Or: Delete entirely when integration removedโ ๏ธ Security Warning: The examples above use placeholder tokens. Never share real tokens publicly or commit them to version control.
Access Requirements
Capability:
manage_options(administrators only)Menu Location: NV oOS โ Token Manager
REST API:
/wp-json/mcp-ai/v1/token-manager/*
For complete documentation, see Token Management Guide.
๐ค ChatGPT Connector
OpenAIโs ChatGPT connector beta currently authenticates exclusively through Auth0. Because NV oOS issues its own assistant-scoped bearer credentials, you can connect LM Studio, Claude Desktop, and other MCP-aware clients today, while ChatGPT support will require either Auth0 bridging or native bearer support from OpenAI. Weโll update this section as soon as ChatGPT adds compatibility with first-party tokens.ใF:docs/reference/api/mcp-server-authentication.mdโ L22-L46ใ
๐ฐ REST API Endpoints
All front-end chat surfaces ultimately call the MCP REST namespace at /wp-json/mcp-ai/v1, which exposes dedicated endpoints for chat completions and direct tool execution. Both routes share the same authentication rules described above: supply an Auth0 bearer token, a plugin-issued assistant credential, or a WordPress REST nonce for same-origin requests. Guest tokens issued by the shortcode or Elementor widget continue to be honoured when allow_guests="true" is enabled.ใF:includes/class-wp-mcp-ai-rest.phpโ L230-L322ใใF:includes/class-wp-mcp-ai-rest.phpโ L289-L343ใใF:includes/class-wp-mcp-ai-rest.phpโ L1288-L1336ใ
GET /assistantsโ Returns a directory of accessible assistants with provider defaults, tool counts, capability metadata, and implementation details so remote clients can choose which assistant to call. Credential tokens are automatically scoped to their issuing assistant while Auth0 tokens and REST nonces surface every published assistant the caller can read.ใF:includes/class-wp-mcp-ai-rest.phpโ L238-L666ใ The endpoint also supports Server-Sent Events for MCP clients that expect streaming discovery payloads, emitting a singledirectoryevent with cache-busting headers before closing the stream.ใF:includes/class-wp-mcp-ai-rest.phpโ L1690-L1772ใGET /sseโ Mirrors the assistant directory response but forces a Server-Sent Events handshake so MCP clients that negotiate/ssesubscriptions receive the streamingdirectorypayload without additional query parameters.ใF:includes/class-wp-mcp-ai-rest.phpโ L400-L715ใPOST /chatโ Normalises structuredmessages, injects assistant defaults, auto-enables the Submit Document Prompt tool when uploads are present, and forwards the request through the language model router. Responses include the assistant ID and the raw provider payload so clients can stream or render messages as needed.ใF:includes/class-wp-mcp-ai-rest.phpโ L230-L322ใใF:includes/class-wp-mcp-ai-rest.phpโ L931-L1095ใPOST /toolsโ Executes a specific registered tool outside of a chat turn. The endpoint enforces assistant tool allowlists, scopes credential-based requests to the issuing assistant, merges assistant defaults (such as external action identifiers), and returns the tool result with execution metadata.ใF:includes/class-wp-mcp-ai-rest.phpโ L264-L322ใใF:includes/class-wp-mcp-ai-rest.phpโ L1162-L1321ใ
See docs/reference/api/rest-api.md for payload examples, attachment handling rules, and troubleshooting tips when integrating custom clients.
๐ SSE Streaming Support
NV oOS includes comprehensive Server-Sent Events (SSE) support for real-time streaming responses, enabling faster perceived response times and better user experience.
What is SSE?
Server-Sent Events provide unidirectional server-to-client streaming over HTTP, allowing the server to push updates as they become available rather than waiting for the complete response.
Benefits:
โก Faster perceived response time - Users see content immediately as it's generated
๐ Real-time updates - Progressive loading for long-running operations
๐ถ Connection keep-alive - Prevents timeouts during lengthy responses
๐ฏ Better UX - ChatGPT-style typing effect for AI responses
SSE-Enabled Endpoints
1. Assistant Directory Streaming (GET /assistants)
Stream the assistant directory for MCP clients expecting SSE handshakes:
curl -H "Accept: text/event-stream" \
https://your-site.com/wp-json/mcp-ai/v1/assistantsThe endpoint emits a single directory event with all accessible assistants, then closes the connection.
2. Dedicated SSE Endpoint (GET /sse)
Force SSE mode for MCP clients that specifically probe the /sse endpoint:
curl https://your-site.com/wp-json/mcp-ai/v1/sseThis mirrors the /assistants response but always uses SSE format, ensuring compatibility with LM Studio and Claude Desktop.
3. Job Status Streaming (GET /jobs/{job_id}/stream)
Subscribe to real-time updates for async operations like Crawl4AI jobs:
const eventSource = new EventSource(
`/wp-json/mcp-ai/v1/jobs/${jobId}/stream?max_duration=300&poll_interval=2`
);
eventSource.addEventListener('status', (e) => {
const status = JSON.parse(e.data);
console.log('Progress:', status.progress + '%');
});
eventSource.addEventListener('complete', (e) => {
console.log('Job finished:', e.data);
eventSource.close();
});SSE Configuration
Enable POST Method for SSE (LM Studio Compatibility)
By default, SSE uses the standard GET method. For clients with SSE bugs (like LM Studio), enable POST support:
Go to Settings โ NV oOS โ Assistant Settings
Enable "Enable POST Method on SSE Endpoint"
Save settings
โ ๏ธ Note: Standard SSE specification uses GET. Only enable POST if you experience client compatibility issues.
Modern SSE Features (2024-2025)
The SSE implementation includes current best practices:
Automatic reconnection with
retry:directive (3-second interval)Event IDs for tracking reconnection state
HTTP/2 compatibility for multiplexing
Proper CORS headers for cross-origin requests
Cache-Control directives to prevent proxy buffering
Heartbeat messages to keep connections alive
Frontend Integration
Enable SSE streaming in your JavaScript client:
// Request streaming in chat
const response = await fetch('/wp-json/mcp-ai/v1/chat', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Accept': 'text/event-stream',
'X-WP-Nonce': wpMcpAi.nonce
},
body: JSON.stringify({
assistant_id: 123,
messages: [{ role: 'user', content: 'Hello' }],
stream: true
})
});
// Process SSE stream
const reader = response.body.getReader();
const decoder = new TextDecoder();
let buffer = '';
while (true) {
const { done, value } = await reader.read();
if (done) break;
buffer += decoder.decode(value, { stream: true });
const events = buffer.split('\n\n');
buffer = events.pop();
for (const event of events) {
if (event.startsWith('data: ')) {
const data = JSON.parse(event.substring(6));
// Update UI with streaming chunk
updateChatUI(data);
}
}
}Documentation
For complete SSE implementation details, configuration options, and troubleshooting:
SSE Streaming Guide - Complete implementation guide with code examples
MCP and SSE - Understanding SSE benefits for MCP protocol
Job Notification System - Real-time job status via SSE
REST API Reference - SSE endpoint specifications
๐ MCP JSON-RPC 2.0 Endpoint
NV oOS implements a dedicated /mcp endpoint that follows the Model Context Protocol specification version 2024-11-05 using JSON-RPC 2.0 for bidirectional communication with AI assistants and tools.ใF:docs/reference/api/mcp-endpoint.mdโ L1-L80ใ
MCP Version: 2024-11-05
Compliance: Full MCP 2024-11-05 โ all 11 protocol methods, OAuth 2.1, Streamable HTTP, JSON-RPC batching, tool annotations, session management
What's New in MCP 2024-11-05
The latest specification is fully implemented:
OAuth 2.1 Security: PKCE, token rotation, mandatory HTTPS
Streamable HTTP Transport: Better reconnection and bidirectional communication
JSON-RPC Batching: Efficient parallel task processing (up to 20 messages per batch)
Tool Annotations:
readOnlyHint,destructiveHint,idempotentHint,openWorldHintmetadataProgress Notifications: Descriptive status updates during tool execution
Completions: Argument autocompletion for tools and prompts
Session Management: State recovery via
Mcp-Session-Idheader (1h TTL)Logging: Client-controlled log verbosity via
logging/setLevelCancellation: Request cancellation via
notifications/cancelled
Endpoint URL
POST /wp-json/mcp-ai/v1/mcpJSON-RPC 2.0 Format
All requests must use standard JSON-RPC 2.0 format:
{
"jsonrpc": "2.0",
"id": "unique-request-id",
"method": "initialize",
"params": {}
}Supported Methods
initialize- Initialize MCP connection and retrieve server capabilitiesping- Server liveness checktools/list- List available tools with annotations for the authenticated assistanttools/call- Execute a specific tool with progress notifications supportresources/list- List available resources (knowledge files, etc.) with metadataresources/read- Read resource content by URI with MIME-typed responsesprompts/list- List available prompt shortcutsprompts/get- Get full prompt content with system instructions and argument valuescompletion/complete- Argument autocompletion (enum/boolean for tools, slug matching for prompts)logging/setLevel- Client-controlled log verbosity (8 standard levels)notifications/cancelled- Cancel a pending request
Authentication (OAuth 2.1 Enhanced)
The MCP endpoint uses enhanced authentication aligned with MCP 2024-11-05 security standards:
WordPress Nonce (
X-WP-Nonceheader)Bearer Tokens (
Authorization: Bearer <token>) with rotation supportAssistant Credentials (generated from assistant editor, OAuth 2.1 compliant)
Auth0 JWT (for enterprise authentication)
Session Management (
Mcp-Session-Idheader for reconnection)
Error Handling
Enhanced Error System (Phase 3):
Severity Levels: CRITICAL, ERROR, WARNING, INFO, DEBUG for categorized logging
User-Friendly Messages: Automatic translation of technical errors into actionable guidance
Recovery Suggestions: Built-in troubleshooting steps for common failure scenarios
Centralized Error Handler: Consistent error creation with automatic logging
Comprehensive Logging: Track errors, tool executions, and chat interactions
Sensitive Data Protection: Automatic redaction of API keys and tokens in logs
See Error Handling Documentation for detailed usage.
MCP Standard Error Codes:
-32700: Parse error (invalid JSON)
-32600: Invalid Request (malformed JSON-RPC)
-32601: Method not found
-32603: Internal error
Use Cases
Scenario | Use Endpoint | Method | MCP 2024-11-05 Feature |
Remote MCP client connection |
| POST | OAuth 2.1, Sessions |
Real-time streaming responses |
| GET | Traditional SSE |
Streamable HTTP (new) |
| POST | Bidirectional streaming |
Standard chat interface |
| POST | N/A |
Direct tool execution |
| POST | Tool annotations |
Learn More
โก๏ธ Complete MCP Documentation:
MCP Endpoint Reference - Complete method documentation and 2024-11-05 features
MCP and SSE Explained - Understanding transport layers and protocol updates
MCP Server Authentication - OAuth 2.1 and security enhancements
MCP Client Configurations - Connect LM Studio, Claude Desktop, etc.
๐ Assistant Editor Overview
Assistant posts ship with dedicated controls that map directly to runtime behaviour:
Available Tools โ Choose which registered tools (core, WooCommerce, JetEngine, or custom) the model may invoke. Dependency-aware notices explain why certain tools are unavailable, and you can now disable the pre-built prompt shortcuts that tools normally contribute.
Quick Tool Selection Presets โ one-click presets group the current live registry by use-case (๐ค Agentic Workflow, ๐ E-commerce, โ๏ธ Healthcare, ๐ฌ Communication, ๐ป Development, ๐ Registration & Compliance, and more). Click a preset to add its tools to the current selection; click again to remove them. Combine multiple presets freely. Use โ Select All / โ Clear All for bulk actions. Implemented in
includes/helpers/class-wp-mcp-ai-tool-presets-helper.php.Model Defaults โ Provide assistant-specific overrides for the OpenAI model, temperature (0โ2), and system prompt applied to every conversation.
Base Knowledge โ Attach Media Library items that are chunked, truncated, and streamed as memory context, and optionally store an external Vector Store ID to coordinate retrieval workflows.
Prompt Shortcuts โ Capture labelled prompts with optional descriptions and tool affinities; they render as accessible quick actions in the chat UI so operators can seed conversations instantly.ใF:includes/assistants/class-wp-mcp-ai-assistant-cpt.phpโ L893-L1048ใใF:includes/class-wp-mcp-ai-shortcode.phpโ L430-L693ใใF:assets/js/chat.jsโ L600-L666ใ
If an API or shortcode request omits the assistant parameter, the plugin automatically uses the default assistant configured in the global settings.
๐ Assistant Storage: CPT vs CCT
NV oOS uses a Custom Post Type (CPT) as the primary storage for AI assistants, with automatic synchronization to a JetEngine Custom Content Type (CCT) when JetEngine is available.
Storage Architecture
CPT (
mcp_ai_assistant): The authoritative source for all assistant dataFull-featured WordPress editor with 14 meta fields
Supports credentials, shortcuts, memory files, and advanced features
Always available in both Base and Full versions
Primary REST endpoint:
/wp-json/mcp-ai/v1/
CCT (
assistants): Synchronized secondary storage (Full Version only)Receives automatic updates when CPT is saved
7 basic fields: title, description, provider, model, system_prompt, temperature, tools
Available via JetEngine REST endpoint:
/wp-json/jet-cct/assistantsIdeal for JetEngine-based integrations and queries
Automatic Synchronization (v1.0.0+)
When you save an assistant through the WordPress admin:
CPT is updated with all settings
CCT is automatically synced (if JetEngine is active)
Link is maintained via
_wp_mcp_ai_cct_item_idmetaDeletion cascades - removing CPT also removes linked CCT item
What gets synced: Basic configuration (title, description, provider, model, system_prompt, temperature, tools)
What's CPT-only: Advanced features (credentials, shortcuts, memory files, role rules, vector store, external actions)
When to Use Each Endpoint
Use CPT endpoint (/wp-json/mcp-ai/v1/) for:
Chat, tools, and directory interactions
Full assistant configuration access
Credential-based authentication
Primary integration scenarios
Use CCT endpoint (/wp-json/jet-cct/assistants) for:
JetEngine-specific queries and filters
Building JetEngine relations
Integrating with JetEngine dashboards
Querying basic assistant metadata
โก๏ธ Read the complete CPT vs CCT guide for detailed comparisons, code examples, and migration information.
โก Assistant Tool Shortcuts
Every assistant exposes a Prompt Shortcuts meta box so editors can curate prewritten instructions, scope them to registered tools, and add operator-facing descriptions that appear as tooltips and screen reader hints in the chat UI.ใF:includes/assistants/class-wp-mcp-ai-assistant-cpt.phpโ L893-L1048ใใF:includes/class-wp-mcp-ai-shortcode.phpโ L430-L693ใใF:assets/js/chat.jsโ L600-L666ใ The shortcode merges these custom prompts with each toolโs declared shortcut tasks and always appends a safe fallback so assistants remain usable even without bespoke entries.ใF:includes/class-wp-mcp-ai-shortcode.phpโ L430-L693ใ
Developers can extend or replace these prompts with filters such as wp_mcp_ai_assistant_custom_tool_shortcuts and wp_mcp_ai_default_tool_shortcut, letting sites tailor default quick actions per assistant or environment.ใF:includes/class-wp-mcp-ai-shortcode.phpโ L444-L692ใ
โก๏ธ Read the full guide to assistant prompt shortcuts.
๐ง Agent Skills
Agent Skills (agentskills.io) are reusable, portable behaviour packages that extend any assistant without touching its system prompt. Each skill is a SKILL.md file โ a standard Markdown document with a small YAML frontmatter block โ that lives in wp-content/uploads/mcp-ai-skills/{skill-name}/SKILL.md. When an assistant loads a skill, its instructions are automatically injected into the conversation context so the model knows exactly when and how to use that capability.
67 Pre-Built Skills (Base Plugin)
The base plugin ships with 67 pre-built skills that are automatically installed to wp-content/uploads/mcp-ai-skills/ on first activation. No Pro add-on is required โ they are available on every install out of the box. The skills include 24 general-purpose tools (document handling, design, testing), 22 WordPress developer skills (security, APIs, plugin patterns), 21 design-* skills (analytics through video creation), and the bundled mcp-ai-wpoos-plugin skill.
Skill slug | What it does |
| Generates algorithmic art with p5.js, seeded randomness, and interactive parameters |
| Applies Anthropic's official brand colours and typography to any artifact |
| Creates beautiful visual art in PNG/PDF documents using design philosophy |
| Guides users through a structured co-authoring workflow for documentation |
| Creates, reads, edits, and manipulates Word |
| Produces distinctive, production-grade frontend interfaces with high design quality |
| Drafts all kinds of internal communications (memos, announcements, updates) |
| Guides creation of high-quality MCP (Model Context Protocol) servers |
| Handles any PDF task โ creation, reading, editing, and form filling |
| Handles any |
| Creates, modifies, and measures the performance of other skills |
| Creates animated GIFs optimised for Slack with design best practices |
| Applies consistent visual themes to slides, docs, and other artifacts |
| Comprehensive UI/UX design system with component libraries, color palettes, typography scales, and stack-specific guidelines (React, Vue, Angular, Laravel, etc.) |
| Builds elaborate multi-component HTML artifacts for Claude.ai |
| Tests local web applications using Playwright browser automation |
| Handles any spreadsheet file as primary input or output |
How Skills Are Loaded
Skills are selected per-assistant via the Skills meta box in the assistant editor. Whichever skills are checked, their combined instructions are prepended to the system prompt under an # Active Skills heading at inference time. This means skills are composable โ you can combine pdf + xlsx + doc-coauthoring on a single document-specialist assistant.
Skills are stored as plain text files and can be customised in-place. The original bundled content can be restored at any time from Settings โ Advanced โ Skill Management โ Force Reinstall Bundled Skills.
Managing Skills
Base plugin โ Skill management is available under Settings โ Advanced โ Skill Management:
View installed skills and their metadata
Refresh the skill index
Install or force-reinstall the 16 bundled skills
Pro add-on โ The dedicated Skill Manager admin page (Assistants โ Skill Manager) adds:
Upload a
SKILL.mdfile or a ZIP archive containing a skill directoryInstall a skill from a remote URL
Inline CodeMirror editor to create or edit
SKILL.mdcontent directly in the browserDelete / uninstall skills
SKILL.md Format
---
name: my-skill
description: One-line description of what this skill does.
compatibility: claude-3-5-sonnet, claude-3-opus
---
# My Skill
Detailed instructions for the model go here in standard Markdown.
Use headings, lists, code blocks โ whatever best conveys the behaviour.The name field (max 64 chars) becomes the skill's slug. The description field (max 1 024 chars) is shown in the admin UI. The compatibility field is optional and informational.
โก๏ธ See Agent Skills reference for the complete specification, filters, and developer API.
๐ Professional & Team Layers
NV oOS includes an enterprise-grade template system for rapid assistant deployment through Professions and Teams. Instead of manually configuring each assistant from scratch, administrators can:
Select from ~311 pre-built professional templates spanning 12 industry categories
Create custom profession templates with reusable configurations
Deploy entire teams of specialized assistants with one click
Test everything from the backend before exposing to end users
๐ Professional Templates
Professions are reusable assistant templates with pre-configured:
Role descriptions and expertise areas
Default tools curated for each profession
Knowledge bases with industry-specific best practices
AI model defaults (provider, model, temperature)
Warnings and disclaimers for professional contexts
Available Categories (~311 professions across 12 categories):
Methodology note: the current sanity check counts 311 profession knowledge documents; runtime availability can vary with seeders, filters, and installed features.
๐พ Agriculture & Natural Resources
๐จ Art, Media & Entertainment
๐ผ Business & Finance
๐ Education
๐ฅ Healthcare & Medicine
โ๏ธ Law & Public Safety
๐ฌ Science & Engineering
๐ฝ๏ธ Service Industry
๐ป Technology
๐ง Trades & Manual Labor
๐ Transportation
๐ Miscellaneous
Example Professions:
Software Developer, Web Developer, Data Scientist
Accountant, Financial Advisor, Marketing Consultant
Registered Nurse, Physician, Pharmacist
Attorney, Paralegal, Mediator
Content Writer, Graphic Designer, Social Media Manager
And ~180 more, depending on active seeders and installed features...
Creating Assistants from Templates
Navigate to AI Assistants โ Add New to browse the visual profession grid:
Browse by category or search for a specific role
Click "Create" on any profession to open a customization modal
Customize the assistant name and AI settings (or use defaults)
Deploy your configured assistant instantly
Each profession template includes:
Pre-written system prompts with role-specific expertise
Curated tool selections appropriate for the profession
Industry knowledge bases and best practices
Recommended model settings for optimal performance
๐ฅ Team Deployments
Teams group multiple professionals for coordinated workflows. Deploy an entire team of specialists with one click:
Pre-Built Teams:
Engineering Team - Software, Mechanical, Electrical, Civil Engineers
Pharmaceutical Development Team - Pharmacist, Researcher, Clinical Pharmacologist, Regulatory Affairs
Research & Data Science Team - Data Scientist, Research Scientist, Statistician, Computer Scientist
Marketing & Growth Team - Marketing Consultant, Content Creator, Graphic Designer, Business Consultant
Team Features:
Centralized configuration - Set provider, model, and temperature for all team members
One-click deployment - Creates all team member assistants simultaneously
Consistent settings - Team defaults override individual profession defaults
Custom teams - Create your own teams with any combination of professions
Navigate to Teams โ Add Team to deploy a pre-configured team or create custom team combinations.
๐งช Backend Testing
Test assistants, professions, and teams directly from the WordPress admin before deploying to end users:
Test Assistant (Admin โ AI Assistants โ Test Assistant)
Full feature parity with frontend chat interfaces
All tools enabled including sensitive/restricted tools (admin-only)
File upload support with complete MIME type configuration
Transcript saving for debugging and analysis
Tool shortcuts pre-loaded from assistant configuration
Streaming responses with real-time feedback
Test Profession (Admin โ Professions โ Test Profession)
Preview profession templates before creating assistants
Validate role descriptions and expertise areas
Test default tool selections in live conversations
Verify knowledge base content and accuracy
Assess AI model performance with profession-specific tasks
Test Team (Admin โ Teams โ Test Team)
Test entire teams before deployment
Validate team member coordination and role separation
Verify shared settings propagate correctly
Multi-assistant conversations to test team dynamics
Performance benchmarking across team members
Security Note: All test pages require manage_options capability and are restricted to WordPress administrators. Sensitive tools are enabled in test environments because administrators already have full site access.
Documentation:
Test Assistant Feature Enhancements - Complete testing capabilities guide
Dynamic Assistant Creation System - Visual guide to profession and team architecture
Custom Professions & Teams
Administrators can create custom profession templates and teams:
Create Custom Profession:
Navigate to Professions โ Add New
Set title, description, and category
Define expertise areas and role description
Select default tools from the registry
Add knowledge base content
Configure AI model defaults
Publish for use in assistant creation
Create Custom Team:
Navigate to Teams โ Add New
Set team name and description
Select profession members from your library
Configure team-wide defaults (provider, model, temperature)
Publish to enable one-click team deployment
Benefits
For Organizations:
โ Rapid assistant deployment without manual configuration
โ Consistent configurations across similar roles
โ Template library grows with your organization
โ Share profession templates across sites
โ Professional-grade assistant quality out of the box
For Administrators:
โ Test everything safely from the backend
โ No coding required for template-based assistants
โ Visual template selection interface
โ Reusable configurations reduce errors
โ Full control over custom templates
For Developers:
โ JSON-based knowledge base system
โ Extensible via filters and hooks
โ WordPress standard CPT architecture
โ REST API access for profession and team data
โ Automated seeding from knowledge base files
๐ Assistant API credentials
Administrators can issue per-assistant access tokens from the API Credentials meta box that appears on every assistant edit screen. Tokens are only available to users with the manage_options capability, surface the credential history in a table, and expose one-click revoke and delete actions for rapid cleanup.ใF:includes/assistants/class-wp-mcp-ai-assistant-cpt.phpโ L483-L595ใ When you click Generate Credential the plugin produces a single-use token in the form cred_xxxxx.SECRET, hashes the secret server-side, and records the issuer so you have an audit trail of who created each credential.ใF:includes/class-wp-mcp-ai-credentials.phpโ L94-L135ใ
Remote integrations can authenticate by sending that token in the standard Authorization: Bearer headerโno Auth0 dependency required. The REST layer validates the credential, emits structured errors when a token is revoked or malformed, and scopes the request to the assistant that issued the token so clients cannot hop between assistants without an explicit credential for each one.ใF:includes/class-wp-mcp-ai-rest.phpโ L316-L444ใใF:includes/class-wp-mcp-ai-rest.phpโ L1282-L1321ใใF:includes/class-wp-mcp-ai-credentials.phpโ L242-L297ใ
๐ณ Local Development with Docker
Spin up a disposable WordPress instance that mounts the plugin source directly into the container:
docker compose up -dWordPress will be available at http://localhost:8000.
The plugin source in this repository is mounted to
/var/www/html/wp-content/plugins/mcp-ai-wpoosinside the container, so edits on your machine are reflected immediately.The MySQL service is provisioned with the
wordpressdatabase, user, and password (wordpress/wordpress).
Visit the site in your browser to complete the standard WordPress installation flow, using the database credentials above when prompted. When you're finished developing, stop the stack with docker compose down.
๐ Codex environment startup script
If you are working inside an OpenAI Codex environment, add bin/codex-startup.sh to your workspace start-up tasks so a fresh WordPress install is provisioned automatically for every session โ no Docker required.
bin/codex-startup.shThe script performs the following steps:
Downloads WP-CLI locally (if necessary) and uses it to fetch the latest WordPress core files into
.codex-wordpress/wordpress.Installs the SQLite Database Integration plugin so WordPress can run without a MySQL server.
Symlinks this repository into the new install's
wp-content/plugins/mcp-ai-wpoosdirectory.Installs Composer development dependencies (when available) and provisions the WordPress test suite so
composer run testworks immediately.Runs
wp core install, activates the NV oOS plugin, enables pretty permalinks, and sets a default site tagline.Boots a development server on port
8000viawp serverand logs output to.codex-wordpress/wp-server.log.
Default credentials:
Setting | Value |
Site URL |
|
Admin user |
|
Admin password |
|
Admin email |
|
Override any of these values by exporting the environment variables WORDPRESS_URL, WORDPRESS_TITLE, WORDPRESS_ADMIN_USER, WORDPRESS_ADMIN_PASSWORD, WORDPRESS_ADMIN_EMAIL, or WORDPRESS_PORT before running the script.
๐งโ๐ป Development Tooling
Install the PHP development dependencies (including PHP_CodeSniffer, the WordPress Coding Standards ruleset, and PHPUnit) with:
bin/setup-dev.shThe script runs composer install and makes the following Composer scripts available:
Purpose | Command |
WordPress coding standards lint |
|
PHP compatibility checks (PHP 7.4โ8.3) |
|
Auto-fix coding standards violations |
|
Generate the translation template |
|
Install the WordPress unit test scaffolding |
|
Execute the PHPUnit suite |
|
These commands automatically resolve the bundled vendor/bin tools (such as phpcs, phpcbf, and phpunit), so a global installation is no longer required.
Thetest:install script prefers the Composer-provided wp-phpunit/wp-phpunit package for the WordPress test suite. Run composer install before invoking it, especially on networks where develop.svn.wordpress.org is inaccessible.
NPM Dependencies & Bundling
For details on how NPM dependencies are managed and bundled for both the base plugin and Pro addon, see DEPENDENCIES_BUNDLING.md.
Quick Reference:
Base plugin dependencies:
@microsoft/fetch-event-source,dompurify,marked,ky,chart.js,@neplex/vectorizer,@langchain/*,@mlc-ai/web-llmBuild commands:
npm run build:js,npm run install:chartjs,npm run install:vectorizer,npm run build:js:proPro addon has separate
addons/pro/package.jsonfor Pro-specific dependencies
๐ฆ NPM Packages
Twenty-three standalone browser-utility packages have been extracted from the oOS chat UI and published to the NPM registry under the @nvdigitalsolutions scope. Each package is independently usable in any JavaScript/TypeScript project (no WordPress required).
Package | Description | Dependencies |
Async JSON via Web Worker โ prevents main-thread blocking for large data | Zero | |
XSS-safe markdown renderer with configurable allowed-tags profile |
| |
SSE client with POST support + mitt-compatible job event bus |
| |
HTTP client with automatic retry, exponential backoff, and request hooks |
| |
| Zero | |
IndexedDB offline-first sync with automatic server sync on reconnect | Zero | |
Slash command system with fuzzy-search autocomplete and execution engine | Zero | |
Browser audio I/O: TTS, STT, translation, voice chat with VAD | Zero | |
| Zero | |
Typed REST API client โ endpoint builders, request helpers, and payload constructors | Zero | |
File attachment helpers: type detection, validation, normalisation, segment builders | Zero | |
Floating chat bubble widget โ accessibility, sessionStorage, badge notifications, MutationObserver | Zero | |
Promise-based REST client for AI chat memory bridge (wake-up, recall, store, audit, preferences) | Zero | |
Chat memory drawer UI โ side panel for viewing, editing, scoping, and exporting long-term AI memories | Zero | |
Browser-native AI tool registry (summarize, sentiment, translate, embed, image, audio) using Transformers.js | Zero | |
SSE-first cron/job status monitor with REST polling fallback | Zero | |
Web Worker manager for non-blocking LLM operations | Zero | |
Progressive AI model loading UI with 4-stage progress tracking | Zero | |
TypeScript-native SSE connection manager with lifecycle tracking, per-connection status, automatic cleanup | Zero | |
MediaRecorder-based audio recording + tool-call transcription pipeline for AI chat surfaces | Zero | |
HuggingFace Transformers.js task wrapper (summarization, sentiment, NER, translation, QA, embeddings) | Zero | |
Canonical TypeScript type definitions โ AI providers, chat messages, tool execution, SSE streaming, attachments, history, memory, agents, WordPress global augmentations | Zero | |
Browser Voice Activity Detection (VAD) using the Web Audio API | Zero |
Installation
# Tier 1 โ Core utilities
npm install @nvdigitalsolutions/nvoos-storage
npm install @nvdigitalsolutions/nvoos-markdown marked dompurify
npm install @nvdigitalsolutions/nvoos-events @microsoft/fetch-event-source
npm install @nvdigitalsolutions/nvoos-types
# Tier 2 โ Extended browser utilities
npm install @nvdigitalsolutions/nvoos-http-client ky
npm install @nvdigitalsolutions/nvoos-clipboard
npm install @nvdigitalsolutions/nvoos-offline-sync
npm install @nvdigitalsolutions/nvoos-sse-client
npm install @nvdigitalsolutions/nvoos-api
npm install @nvdigitalsolutions/nvoos-attachments
# Tier 3 โ Chat UI utilities
npm install @nvdigitalsolutions/nvoos-slash-commands
npm install @nvdigitalsolutions/nvoos-audio
npm install @nvdigitalsolutions/nvoos-dom-batcher
npm install @nvdigitalsolutions/nvoos-chat-bubble
npm install @nvdigitalsolutions/nvoos-chat-memory
npm install @nvdigitalsolutions/nvoos-chat-memory-ui
npm install @nvdigitalsolutions/nvoos-cron-status
npm install @nvdigitalsolutions/nvoos-vad
npm install @nvdigitalsolutions/nvoos-transcription
# Tier 4 โ AI runtime utilities
npm install @nvdigitalsolutions/nvoos-client-tools
npm install @nvdigitalsolutions/nvoos-llm-worker
npm install @nvdigitalsolutions/nvoos-model-loader
npm install @nvdigitalsolutions/nvoos-transformers-clientPublishing
Two GitHub Actions workflows handle NPM publishing automatically:
Workflow | Trigger | Tag pattern |
| Push tag or |
|
| Push tag or |
|
Setup โ only one secret is required: add an NPM_TOKEN to the repository at Settings โ Secrets and variables โ Actions.
Adding a new package: update the PACKAGES environment variable in both workflow files and place the package directory under packages/.
See packages/README.md for a full package listing and API overview, and packages/QUICK_START.md for usage examples.
๐งช Testing & QA
composer run testexecutes the PHPUnit suite bundled withwp-phpunit/wp-phpunitand Yoastโs polyfills, covering REST, tooling, and helper contracts.ใF:composer.jsonโ L16-L23ใRun
composer run test:installonce per environment to provision the WordPress test scaffolding before the first test pass.ใF:composer.jsonโ L16-L23ใFor offline or air-gapped environments, use
./bin/package-vendor-dev.shto create a downloadable test framework package (~140 MB), then./bin/install-vendor-dev.shto deploy it without requiring composer or internet access.
Coding standards & static analysis
Enforce the WordPress Coding Standards with
composer run lint; auto-fix what you can withcomposer run format.ใF:composer.jsonโ L16-L23ใValidate cross-version compatibility (PHP 7.4โ8.3) via
composer run lint:compatprior to release builds.ใF:composer.jsonโ L16-L23ใ
Manual smoke tests
Follow the scenarios in ## โ Manual QA Scenarios after significant changes to chat flows, tool execution, or authentication wiring.
For logging-centric debugging, enable logging in the NV oOS settings and reference the retrieval commands in ๐ชต Logging.
โ๏ธ CI/CD Pipelines
The repository runs ~30 automated GitHub Actions workflows on every push and PR:
Workflow | Purpose |
| PHPUnit test suite (PHP 8.1, MySQL 8.0) |
| Jest-based JS test suite |
| PHPCS + PHP compatibility (7.4โ8.3) |
| Dependency vulnerability scanning |
| Security regression tests |
| Build all SPA addon ZIPs |
| Canvas addon ZIP build |
| Comic Reader addon ZIP build |
| Graphify standalone plugin builds (3 workflows) |
| NPM package publishing (stable + alpha) |
| GitHub Release automation |
| Cross-provider chat parity testing |
| End-to-end QA tests |
| WCAG 2.1 AA accessibility checks |
| SPA bundle size monitoring |
| Documentation link validation |
| Cloud Worker integration tests |
| Post-deployment health checks |
| lib/ package sync to standalone repos (5 workflows) |
| Stale issue/PR management |
| Automated PR labeling |
| GitHub project board automation |
๐ฌ Frontend Shortcode
Embed a published assistant anywhere on the site with the shortcode. Replace 123 with the post ID of the assistant you created under AI Assistants.
[mcp_ai_chat assistant="123"]How it works
The shortcode renders a lightweight chat UI that talks to the plugin's REST API endpoints.
Scripts and styles are enqueued automatically and include REST nonces plus the selected assistant ID.
Responses are displayed inline, including tool invocation feedback when the model requests a registered tool.
Requirements
The assistant post must be published and, by default, the current user must have the
edit_postscapability (matching the REST permission check). Addallow_guests="true"to the shortcode when you want anonymous visitors to participate in the chat.An OpenAI API key and default model must be configured in Settings โ NV oOS.
Tips
Omit the
assistantattribute to fall back to the default assistant configured in the settings screen.Multiple shortcodes can be added to the same page; each chat instance maintains its own conversation context on the client.
Use
allow_guests="true"to expose the chat UI to logged-out visitors. Each render issues a short-lived guest token that authorises REST requests without a WordPress login.REST interactions rely on the
[wp_rest]nonce, so caching plugins should avoid caching pages for logged-in editors running the chat.
Elementor widget
Elementor sites automatically gain an NV oOS Chat widget that mirrors the shortcode controls, including the optional assistant selector and the guest access toggle.ใF:includes/elementor/class-wp-mcp-ai-elementor-widget.phpโ L17-L109ใ
Leaving the assistant control blank falls back to the default assistant configured in the plugin settings, and enabling Allow Guests injects the same temporary tokens used by the shortcode flow.ใF:includes/elementor/class-wp-mcp-ai-elementor-widget.phpโ L45-L110ใใF:includes/class-wp-mcp-ai-shortcode.phpโ L132-L224ใ
The Elementor chat widget can surface everything saved on the assistant postโmodel defaults, knowledge files, prompt shortcuts, and assigned toolsโso you can build documentation and dashboards without copying values manually.ใF:includes/elementor/class-wp-mcp-ai-elementor-widget.phpโ L95-L845ใ
๐งต REST Chat Payloads & Attachments
The /wp-json/mcp-ai/v1/chat endpoint accepts rich, multi-part messages. Each message object still requires a role, but the
content may now be either a plain string or an array of structured segments that map to OpenAI's multimodal contract.
{
"assistant_id": 123,
"messages": [
{
"role": "user",
"content": [
{ "type": "text", "text": "Describe this photo" },
{ "type": "input_image", "attachment_id": 456, "detail": "high" }
]
}
],
"options": {
"response_format": { "type": "json_schema", "json_schema": { "name": "caption" } }
}
}Supported segment types
textโ Free-form text (textproperty). Strings supplied directly tocontentare automatically wrapped in this format. For backwards compatibility, existinginput_textpayloads sent to the REST API are still accepted and normalised to the new schema.input_imageโ Reference an uploaded WordPress attachment (attachment_id) or provide a remoteurl. Optionaldetailhints (low,auto,high) andcaptionfields are preserved. (Fixed in v1.0.0: Chat client attachments now properly processed)input_fileโ Reference an uploaded attachment that should be streamed to the model. (Fixed in v1.0.0: Chat client file attachments now properly processed)
The REST controller validates attachment ownership/permissions, enforces a default 5โฏMB size cap (filterable via
wp_mcp_ai_max_attachment_bytes), and only allows safe MIME types by default. Text and structured data formats include
Markdown, CSV/TSV, HTML, JSON/JSONL/NDJSON, and XML; binary documents cover PDFs and Microsoft Word/PowerPoint/Excel variants;
and audio/video uploads accept AAC/FLAC/M4A/MP3/OGG/OPUS/WAV/WEBM plus MP4 or QuickTime sources. ใF:includes/class-wp-mcp-ai-message-attachments.phpโ L642-L709ใ
Whenever attachments are present, the plugin automatically inlines the asset data when sending requests to OpenAI's Responses API. Image segments are converted to data URLs and file segments include the base64-encoded payload alongside the original filename, so integrators do not need to upload assets manually before invoking a model.
REST requests that include attachments automatically gain access to the bundled Submit Document Prompt tool so the files reach OpenAI even when the assistant has the tool disabled in its configuration.ใF:includes/class-wp-mcp-ai-rest.phpโ L22-L29ใใF:includes/class-wp-mcp-ai-rest.phpโ L963-L991ใ
Assistant memory files configured on the post (memory_files) are also promoted to structured text segments on the
system channel, retaining the existing chunking/truncation safeguards.
Need to relax or tighten the allowed file types? Administrators can override the image and file MIME lists directly in Settings โ NV oOS โ Attachments, and the same values are used by shortcode-driven chat surfaces (including the Elementor widget) when building upload restrictions.ใF:includes/admin/class-wp-mcp-ai-admin-settings.phpโ L225-L267ใใF:includes/class-wp-mcp-ai-message-attachments.phpโ L456-L565ใใF:includes/class-wp-mcp-ai-shortcode.phpโ L197-L218ใ When JSON Lines support is enabled in the allowlist the plugin also registers .jsonl and .ndjson extensions with WordPress so uploads succeed without additional filters.ใF:mcp-ai-wpoos.phpโ L236-L272ใ
Assistants can also query existing knowledge files with the Search Attachments tool, which reuses WP_MCP_AI_Message_Attachments::user_can_access_attachment() so only publicly accessible or user-owned media is returned alongside download URLs and file metadata for the model to reuse.ใF:includes/tools/class-wp-mcp-ai-tool-search-attachments.phpโ L15-L207ใใF:includes/class-wp-mcp-ai-message-attachments.phpโ L480-L575ใ
๐ JetEngine Capability Reference
When the plugin interacts with JetEngine objects it defers to the capabilities enforced by JetEngineโs own REST handlers and editor interfaces. Use the following table to review the specific capability checks that gate each object type:
Object / Context | Capability string(s) | Notes |
Custom Post Type editor & REST endpoints |
| Editing built-in post types and all CPT REST endpoints require the user to have |
Custom Taxonomy editor & REST endpoints |
| Built-in taxonomy edits and every taxonomy REST endpoint enforce the |
Relation management UI & REST endpoints |
| Creating, editing, listing, or deleting relations through the admin REST handlers requires |
Relation REST access settings ( | Stored capability string or | The public REST controller checks a capability stored in relation args; if blank or |
Relation object type โPostsโ |
| Editing or deleting related post items requires the corresponding post capability for the specific post ID. |
Relation object type โTaxonomy Termsโ |
| Term relations check the matching term capabilities for the targeted term ID. |
Relation object type โMix โ Usersโ |
| Editing user relations needs |
Relation object type โCustom Content Types (CCT)โ | Configured capability (defaults to | Relation checks defer to the CCTโs |
๐ฐ JetEngine REST API Reference
๐ Review the full endpoint catalogue in
docs/reference/api/jet-engine-rest-routes.mdfor route paths, callbacks, and required parameters.๐ค When JetEngine is active, assistants can invoke the List JetEngine REST Routes tool to retrieve the same metadata directly inside a conversation (requires a user with the
manage_optionscapability).
๐ชต Logging
Enable or disable logging from Settings โ NV oOS โ Enable Logging.
When logging is enabled the plugin records:
Chat requests and responses processed by the REST API.
Tool executions (including permission denials).
Errors returned from the OpenAI API and internal validation.
Log entries are written via PHP's
error_log()and can be filtered withwp_mcp_ai_log_entryto route them elsewhere.ใF:includes/class-wp-mcp-ai-logger.phpโ L16-L137ใRecent errors and activity snapshots are also persisted in the
wp_mcp_ai_recent_errors(50 entries) andwp_mcp_ai_recent_activity(100 entries) options for dashboards and widgets, keeping autoload disabled to avoid bloating frontend requests.ใF:includes/class-wp-mcp-ai-logger.phpโ L611-L662ใRetrieve those rolling buffers quickly with WP-CLI when debugging production incidents:
wp option get wp_mcp_ai_recent_errors --format=json wp option get wp_mcp_ai_recent_activity --format=json
๐งพ JetEngine REST Endpoint Report Helper
Use the JetEngine report helper to surface the CRUD coverage matrix that was compiled during the REST endpoint audit. The helper exposes the underlying endpoint metadata as a structured array so you can reuse it in documentation, dashboards, or custom checks.
$report = wp_mcp_ai_get_jetengine_endpoint_report();
foreach ( $report['coverage'] as $resource => $operations ) {
printf( "%s supports: %s\n", ucfirst( $resource ), implode( ', ', array_keys( array_filter( $operations ) ) ) );
}
if ( empty( $report['missing'] ) ) {
echo "All CRUD operations are covered.";
}The helper is filterable via:
wp_mcp_ai_jetengine_endpoint_routesโ Adjust the source routes before the coverage matrix is derived.wp_mcp_ai_jetengine_endpoint_coverageโ Modify the generated CRUD coverage.wp_mcp_ai_jetengine_missing_operationsโ Override the derived list of missing operations per resource.
Each filter receives the full data set so you can extend or replace the output when JetEngine adds new endpoints or when your project needs to surface additional metadata.
๐ Optional Tools & Dependencies
NV oOS works perfectly with vanilla WordPress - you don't need any third-party plugins for core functionality.
However, certain features require third-party plugins (sold separately). The plugin automatically detects which plugins are active and enables the corresponding tools:
Plugin Detection & Tool Loading
JetEngine (5 tools) โ Server-side chat transcripts, JetEngine content access, JetFormBuilder integration
WooCommerce (3 tools) โ E-commerce automation, product/order management
Elementor (1 tool + widgets) โ Template management, pre-built chat widgets
Rank Math SEO (1 tool) โ SEO analysis and schema data access
WPCode (1 tool) โ Code snippet management and automation
๐ See the complete breakdown: ๐ What You Lose Without Third-Party Plugins
How It Works
Each tool description in the admin UI shows which plugin it requires
Tools are automatically hidden when their dependency is missing
Administrators see informational notices explaining unavailable tools
No errors occur - the plugin gracefully handles missing dependencies
โ Manual QA Scenarios
The project currently relies on manual verification. Run these checks after updating the plugin:
Baseline (no optional plugins)
Deactivate WooCommerce and JetEngine.
Load the AI Assistant edit screen and confirm only core tools appear. No PHP notices or fatal errors should occur.
Visit the WordPress dashboard to confirm the informational notices explain why optional tools are disabled.
WooCommerce enabled
Activate WooCommerce.
Reload the Assistant editor and ensure the WooCommerce Orders and Products tools appear and can be selected.
Trigger each tool (e.g., via an assistant conversation) and confirm recent orders and product summaries return without errors.
JetEngine enabled
Activate JetEngine.
Confirm the JetEngine Items tool appears for assistants and returns data for a configured JetEngine post type.
Tool call retry resilience
Initiate a chat conversation that triggers a tool call (for example, request an operation that requires either WooCommerce tool).
After the tool output appears, send a follow-up message that prompts the assistant to continue without invoking another tool.
Confirm the follow-up succeeds without a JavaScript console error referencing a missing
tool_call_id.
Document the results of each scenario when preparing releases to ensure optional integrations remain stable.
๐งฉ Hooks & Filters
Use the following hooks to extend the plugin:
Hook | Type | Description |
| Action | Fires before a chat request is sent to OpenAI. |
| Action | Fires after a chat response is received. |
| Filter | Modify the OpenAI request options before dispatch. |
| Filter | Adjust the capability required to use the chat shortcode and REST endpoints (defaults to |
| Action | Runs immediately before a tool executes. |
| Filter | Inspect or transform tool output before it is returned. |
| Action | Runs after a tool completes execution. |
| Filter | Intercept or redirect logging output. |
| Filter | Add, remove, or modify onboarding wizard use-case presets. Each preset defines tools, system prompt, temperature, and assistant name. |
| Action | Fires after the onboarding wizard creates assistant CPT posts from selected presets. |
๐งฐ WP-CLI Commands
Manage the NV oOS environment from the command line when WP-CLI is available.
Command | Description |
| Summarises WordPress core details, PHP version, and NV oOS supported plugin coverage. |
| Probes a remote MCP REST namespace (such as |
| Lists optional dependencies (WooCommerce, JetEngine, etc.) with install and activation state. |
| Activates a supported plugin; pass |
| Deactivates a supported plugin; pass |
| Sends a one-shot chat message to an assistant via the language model router. Accepts |
| Recalls agent memory entries. Use |
| Lists chat threads. Use |
| Lists all 15 AI providers with enabled/disabled status. Also supports |
| Lists scheduled cron jobs tracked by NV oOS. Also supports |
| Lists transcripts eligible for mining. Use |
| Lists pending human-in-the-loop approval items. Accepts |
| Lists all registered tools with status, capability, and toolkit metadata. Accepts |
| Lists all published AI assistants. Accepts |
| Lists API credentials configured for an assistant. |
| Lists registered slash commands. |
| Retrieves all NV oOS settings. |
| Clears the NV oOS object cache. |
wp mcp-ai remote accepts additional flags so you can mirror the authentication mode used by your deployment while exercising TLS and timeout controls:
--token=<token>โ Include an Auth0 access token or assistant-issued credential via theAuthorizationheader.--guest-token=<token>โ Attach a guest token when testing public chat surfaces that rely on theX-WP-MCP-AI-Guestheader.--nonce=<nonce>โ Supply a WordPress REST nonce for same-origin checks.--assistant-id=<id>โ Hint which assistant to load when the directory endpoint supports scoped tokens.--timeout=<seconds>โ Override the default 15-second timeout when probing slow networks.--verify-ssl=<boolean>โ Toggle certificate validation (defaults totrue).--user-agent=<agent>โ Send a custom user agent instead of the built-inWP-MCP-AI-Remote-Tester/<version>signature.
Filter wp_mcp_ai_supported_plugins to expose additional managed dependencies to the CLI helpers.
Each hook receives sanitized data and respects the current user's permissions and multisite membership.
๐ Getting Help & Support
Documentation Resources
Start with the comprehensive documentation before seeking additional support:
Quick Reference Guide - Fast answers to common questions and tasks
Documentation Index - Navigate all 1,600+ documentation files
Troubleshooting Guide - Solutions to common issues
REST API Reference - Complete API documentation
Before Reporting Issues
When encountering problems, please:
Check the troubleshooting guide
Enable logging in Settings โ NV oOS to capture detailed errors
Review the common issues section below
Search existing GitHub issues
Test with a default assistant to isolate configuration issues
Common Issues
npm EACCES Permission Error (package-lock.json)
If you get EACCES: permission denied, open '.../package-lock.json' when running npm install:
This means you do NOT need to run npm install.
The plugin distributes pre-built minified assets (.min.js/.min.css files) so npm install is never required for production use. You only need npm if you are a developer modifying JavaScript source files.
Solutions:
If installing from ZIP: Simply upload and activate the plugin. No npm commands needed.
If cloning the repository for production use: Activate the plugin as-is. The pre-built assets in the repository are ready for production.
If you need to rebuild assets (development only): Run npm on a development machine where you have write access, then deploy the built files.
If you must run npm in a restricted directory (e.g., during CI or scripted deployments), use:
npm install --no-package-locknpm/Composer Install Error After Cloning
If you get ENOENT: no such file or directory, uv_cwd (npm) or getcwd() failed (composer) errors:
For Cloudways Users (Most Common):
These errors occur when you try to run npm or composer from a directory that has been moved, deleted, or no longer exists. This commonly happens when you clone outside the WordPress plugins directory and then move/copy files while your shell session is still in the original location.
Solution: Always clone directly into the plugins directory:
# SSH into your Cloudways server
cd /home/master/applications/YOURAPP/public_html/wp-content/plugins/
# Clone directly (replace YOURAPP with your application name)
git clone https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git
cd mcp-ai-wpoos
# Verify you're in the right place
pwd # Should show the full plugins path
# NOTE: npm install is NOT required for production use.
# Activate the plugin in WordPress admin - it is ready to use.
# Only run composer if you need to update PHP dependencies (development only):
# composer install --no-devFor Local Development or VPS:
Ensure you're in the correct directory - Run
pwdto verify you're in themcp-ai-wpoosdirectoryDo not run commands from a moved/deleted directory - If you moved files, open a new terminal session in the new location
Production workflow (no npm or composer needed):
# Clone the repository git clone https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git # Copy to WordPress plugins directory cp -r mcp-ai-wpoos /path/to/wordpress/wp-content/plugins/ # Plugin is ready to activate - no build step required.Development workflow (only if you need to rebuild JS/CSS assets):
# Clone the repository on your development machine (not the server) git clone https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git cd mcp-ai-wpoos # Install dev dependencies and rebuild assets npm install && npm run build composer install --no-dev # Deploy built files to the serverAlternative: Clone directly into WordPress - This avoids copy/move issues:
cd /path/to/wordpress/wp-content/plugins/ git clone https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git # Activate the plugin - it is production-ready without any npm or composer commands.
Chat Not Working
Verify OpenAI API key is configured in Settings โ NV oOS
Ensure assistant is published
Check user has
edit_postscapability or addallow_guests="true"to shortcodeEnable logging and check browser console for errors
Tool Execution Failures
Verify tool is enabled for the assistant
Check required dependencies are installed (WooCommerce, JetEngine, etc.)
Ensure user has necessary capabilities
Review tool-specific requirements in tool reference
Remote Client Connection Issues
Verify credentials are correct and not expired
Test with remote client quickstart guide
Use WP-CLI command:
wp mcp-ai remote <url> --token=<token>Review authentication documentation
Reporting Issues
When creating a GitHub issue, please include:
Plugin version (found in WordPress admin)
WordPress version and PHP version
Error messages from logs (enable logging in settings)
Steps to reproduce the issue
Expected behavior vs actual behavior
Screenshots if applicable
Create issues at: https://github.com/nvdigitalsolutions/mcp-ai-wpoos/issues
Contributing
We welcome contributions! Please see:
CONTRIBUTING.md - Contribution guidelines
MASTER_CONSOLIDATION_2025.md โญ START HERE - Complete consolidation of ALL fixes, summaries, and code reviews (98/100 score)
CONSOLIDATION_MAP.md - Detailed map showing what was consolidated from where
CODE-REVIEW-MASTER.md - Code quality standards with historical reviews
ACTION_ITEMS.md - Current development priorities
Documentation
Comprehensive documentation is available:
MASTER_CONSOLIDATION_2025.md โญ PRIMARY REFERENCE - Single source of truth for all 2025 work
CONSOLIDATION_MAP.md - Navigation guide and source document mapping
DOCUMENTATION_INDEX.md - Complete documentation index (535+ files)
CODE-REVIEW-MASTER.md - Master code review (98/100)
TESTING_AND_QUALITY_REPORT.md - Testing & quality analysis
For Historical Reference:
CONSOLIDATED_BUGS_AND_FIXES.md - All bugs and fixes (superseded by MASTER_CONSOLIDATION_2025.md)
CONSOLIDATED_SESSION_SUMMARIES.md - Development history (superseded by MASTER_CONSOLIDATION_2025.md)
Security Vulnerabilities
For security issues, please review our Security Policy and report vulnerabilities responsibly.
Do not create public GitHub issues for security vulnerabilities.
Community & Updates
GitHub Repository: https://github.com/nvdigitalsolutions/mcp-ai-wpoos
Maintained by: NV Digital Solutions
License: GPLv3 or later
๐ License
NV oOS ships under a three-tier license model:
Component | License |
Base plugin (root + | |
| AGPL-3.0-or-later (bundles |
| Proprietary โ ยฉ NV Digital Solutions, all rights reserved |
The base plugin's GPL-3 grant is in LICENSE. Bundled third-party
dependencies retain their upstream licenses; see CREDITS.md
for the full attribution index.
Thank you for using Open Operator System!
This server cannot be deployed
Maintenance
Related MCP Connectors
Security-first WordPress MCP server. 129 tools for Claude, ChatGPT, Gemini. Free on wp.org.
Secure MCP Server for WordPress connects AI assistants and agents to WordPress with secure, controlled access. It lets AI interact with WordPress through MCP while helping organizations manage access, enforce policies, protect non-human identities (NHI), and require human approval for sensitive actions. Use it to securely connect tools such as ChatGPT, Claude, and Cursor with WordPress. Marketplace Link: https://wordpress.org/plugins/miniorange-secure-mcp-server/ Official website: https://plugins.miniorange.com/mcp-server-ai-policy-enforcement-wordpress
WordPress MCP server: generate SEO posts, AI images, autoblog & WooCommerce on your self-hosted site
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage and interact with WordPress sites through MCP, providing tools for content creation, moderation, WooCommerce operations, and governance.47GPL 2.0
- AlicenseNot gradedqualityAmaintenanceA self-contained MCP server plugin that connects WordPress to AI, providing 58 abilities for managing posts, pages, media, users, plugins, menus, comments, and more through any MCP-compatible AI client.161GPL 2.0
- AlicenseNot gradedqualityAmaintenanceTurns any WordPress site into an MCP server, allowing AI clients to directly control files, database, WP-CLI, PHP, content, and more through declarative abilities without writing code.1GPL 2.0
- AlicenseNot gradedqualityAmaintenanceA free WordPress plugin that turns your site into a governed MCP server, exposing 153 curated WordPress abilities (posts, media, users, WooCommerce, ACF, SEO) as tools for AI agents like Claude and Cursor. Every ability is off by default, scoped to a least-privilege user, capability-gated, and logged.3GPL 2.0