=== AC Vibe ===
Contributors: tshepho96, freemius
Tags: ai, mcp, claude, content, seo
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect Claude, Cursor, ChatGPT or any MCP client to WordPress. Drafts first, a human approves, and every change can be undone.

== Description ==

AC Vibe turns your WordPress site into a Model Context Protocol (MCP) server, so an AI assistant can do real content work on it. The difference is the safety layer around that work: the AI writes drafts, a person approves anything that goes live, every call is logged, and every change can be rolled back.

All of the safety features are in the free plugin and stay there.

= What the AI can do (free) =

45 tools, including:

* Draft and edit posts and pages. Creation is always draft-first.
* Publish and schedule, behind a setting that is off by default and an approval step that is on by default
* SEO titles, meta descriptions and focus keywords for Yoast SEO, Rank Math and SEOPress, with a built-in fallback when no SEO plugin is installed
* Alt text, featured images, and importing an image from a URL
* Categories, tags, comments, custom fields you allow, slugs with automatic 301 redirects
* Site health and SEO gap reports

= Safety, all free =

* Approvals: publishing and trashing wait for a human in wp-admin, with a before/after diff. You can require approval for every write.
* dry_run on every write tool, so the AI can show you a change before making it
* Undo and rollback: every write is checkpointed, including the SEO meta, alt text and featured images that WordPress revisions do not cover
* An audit log of every call, with per-operator tokens you can revoke one at a time
* Block-native writes: HTML becomes real Gutenberg blocks, validated against the blocks registered on your site before anything is stored
* Pages built with Elementor, Divi, Bricks and other builders are detected, and content writes are refused instead of silently doing nothing
* The AI runs as a dedicated least-privilege user that cannot log in. There is no code execution, no WP-CLI and no plugin, theme or user management.

= AC Vibe Pro =

Paid plans add work at scale. Nothing in the free plugin is locked or limited.

* Bulk edits: SEO fields, alt text, featured images or status on up to 50 posts in one call, reversible as a group
* Link intelligence: orphan pages, broken internal links, anchor text, keyword cannibalisation, internal link suggestions and a content decay report
* Media pipeline: stock photo search with your own Unsplash or Pexels key, image upload from data, and in-place compression
* Agency plan: white label (rename the product, author and user agent) across 25 sites

Pro and Agency include a 14-day free trial with no card required.

= Connecting =

Generate a token under AC Vibe in wp-admin, then add the endpoint to your MCP client. Recipes for Claude Code, Cursor and mcp-remote are on the settings screen.

== Installation ==

1. Install AC Vibe from Plugins > Add New, or upload the zip.
2. Activate it.
3. Go to AC Vibe in wp-admin, generate a token, and paste the connection recipe into your AI client.

== Frequently Asked Questions ==

= Can the AI publish without me? =

Not by default. Publishing is off until you turn it on, and when it is on, each publish waits in the approvals queue until a person approves it.

= Can I undo what the AI did? =

Yes. Every write records a checkpoint first. Undo the last change, roll back a batch, or restore any entry from the History screen.

= Does AC Vibe send my content anywhere? =

No. Your AI client connects to your site; AC Vibe does not relay content through any server of ours. See External services below for the calls it can make.

== External services ==

AC Vibe connects to outside services only in these cases:

* **Importing an image from a URL.** When the AI calls upload_media, the site downloads the image from the address the AI supplied. Only that request is made, to that address.
* **Freemius.** Licensing, the upgrade screen and the optional usage opt-in are handled by the Freemius SDK. If you opt in, basic site and plugin data (site URL, WordPress and PHP versions, plugin version, admin email) is sent to Freemius. If you skip, nothing is sent. Terms: https://freemius.com/terms/ Privacy: https://freemius.com/privacy/
* **Stock photo search (Pro only).** With your own API key, search terms are sent to Unsplash (https://unsplash.com/terms, https://unsplash.com/privacy) or Pexels (https://www.pexels.com/terms-of-service/, https://www.pexels.com/privacy-policy/). Nothing is sent without a key.

== Changelog ==

Full detail for every release is in CHANGELOG.md.

= 2.0.1 =
* Packaging for WordPress.org: the Freemius SDK now lives in vendor/freemius. Tested up to WordPress 7.1.

= 2.0.0 =
* Free and Pro. The free plugin keeps every safety feature and 45 tools. Bulk edits, link intelligence, the media pipeline and white label move to paid plans, with a 14-day free trial.
* Updates now come from WordPress.org, and support from the WordPress.org forum and the in-plugin contact form. The self-hosted GitHub updater and the built-in support mailer are removed.

= 1.10.0 =
* Stock photo search via your own Unsplash or Pexels key.
* Add images from inline data (for AI-generated images), with the real file type read from the data rather than the filename.
* Shrink oversized images in place — the URL never changes and the original is backed up first.
* Dashboard widget: connection status, pending approvals, rejected attempts and recent activity.

= 1.9.0 =
* White label: rename the plugin, the author name shown on AI edits (this appears in your revision history), and the HTTP user agent — all from settings.
* MCP prompts: five workflow playbooks (write and schedule, SEO gap sweep, internal link audit, refresh stale content, alt-text backfill) with the review steps built in.
* MCP resources: live site context — content types in scope, block patterns, real taxonomy, writable custom fields, and the approval rules in force.
* House style: write your tone-of-voice and editorial rules once in settings and the AI follows them in every conversation.

= 1.8.0 =
* Per-operator tokens: issue one per person or machine, see who did what in the audit log, and revoke one without breaking everyone else.
* New History & Rollback screen: filter by tool, outcome, operator and date, revert any entry or a whole batch, export CSV.
* Importing images now works with extensionless CDN and stock-photo URLs, checks the real file type, and honours a size limit.

= 1.7.0 =
* SEO plugin coverage: Yoast, Rank Math and SEOPress, plus a built-in fallback that stores and outputs your meta description when no SEO plugin is installed. All in One SEO is detected and explained rather than written to blindly.
* Failed connection attempts are now logged and throttled, with an escalating lockout and a rejected-attempt count on the settings screen. No raw IP addresses are stored.
* Audit log retention (default 90 days), pruned daily.
* Internal link graph: find orphan pages, broken internal links, anchor-text over-optimisation and keyword cannibalisation — plus internal-link suggestions that come with the exact one-block edit to apply.
* content_decay_report ranks what to refresh next by staleness weighted by inbound links.
* site_health: read-only technical check including overdue cron events and autoloaded option weight.

= 1.6.0 =
* Site model: owner-configurable post types and taxonomies (no code needed), custom fields behind an explicit allowlist, ACF awareness.
* Scheduling with correct timezone handling, plus set_post_status and list_scheduled_content.
* Slug changes create a 301 automatically; own redirect manager that only fires on URLs that would 404.
* Bulk engine: SEO fields, alt text, featured images and status across up to 50 items per call, with per-item outcomes and one-group rollback.
* uninstall.php no longer risks deleting content authored by the bridge when no administrator is found.

= 1.5.0 =
* Approval Plane: dry_run on every write tool, block- and meta-aware diffs, and an approvals queue so a human can veto a change before it commits.

= 1.4.0 =
* Renamed to AC Vibe (Audience Connect Vibe). Endpoint is now /wp-json/ac-vibe/v1/mcp.
* Block-native authoring: plain HTML is converted into real Gutenberg blocks instead of one Classic block, and nothing is ever dropped in conversion.
* Server-side block validation against the block types actually registered on your site, before anything is written.
* New tools: list_available_blocks, get_block_schema, list_block_patterns, validate_blocks, list_blocks, render_post_preview, scan_block_damage.
* Draft review that actually works: in-process rendering plus signed, expiring preview links that need no login.
* Block-scoped find-and-replace via block_index.

= 1.3.0 =
* Fixed content corruption: Gutenberg block markup is no longer run through wp_kses_post(), which collapsed WordPress preset variables and deleted iframe embeds.
* Time Machine: list_revisions, restore_revision, undo_last_change, rollback_recent — including the SEO meta, alt text and featured images that WordPress revisions do not cover.
* Page-builder pages (Elementor, Divi, Bricks, Beaver Builder, Oxygen, WPBakery, Avada) are detected and content writes refused rather than silently doing nothing.
* Tool annotations, structuredContent, MCP revision 2025-11-25 with negotiation.
* SEO reports now cover pages, not just posts. Publishing is off by default.

= 1.2.0 =
* Fixed data-loss bugs in replace_in_post and update_media_alt, added server-side argument validation, refused trashing on sites with the Trash disabled, and fixed the unauthenticated GET request loop against the MCP endpoint.

= 1.1.0 =
* Renamed to Audience Connect AI Bridge.
* 6 new tools: replace_in_post (surgical edits), upload_media (import image from URL), list_seo_gaps (actionable fix-lists), list_comments + moderate_comment, get_page_html (rendered front-end, same-domain only).
* Optional WooCommerce products support (content fields only; off by default).
* Connector role: comment moderation + product capabilities; auto-refresh on upgrades.

= 1.0.0 =
* Initial release: MCP JSON-RPC endpoint, 16-tool registry, token auth, dedicated role, audit log, admin UI.
