Title: KOZ Site Bridge
Author: Tony_Koz
Published: <strong>October 19, 2026</strong>
Last modified: October 20, 2026

---

Search plugins

![](https://ps.w.org/koz-site-bridge/assets/banner-772x250.png?rev=3754789)

![](https://ps.w.org/koz-site-bridge/assets/icon-256x256.png?rev=3754789)

# KOZ Site Bridge

 By [Tony_Koz](https://profiles.wordpress.org/ramirkz/)

[Download](https://downloads.wordpress.org/plugin/koz-site-bridge.0.6.0.zip)

 * [Details](https://wordpress.org/plugins/koz-site-bridge/#description)
 * [Reviews](https://wordpress.org/plugins/koz-site-bridge/#reviews)
 *  [Installation](https://wordpress.org/plugins/koz-site-bridge/#installation)
 * [Development](https://wordpress.org/plugins/koz-site-bridge/#developers)

 [Support](https://wordpress.org/support/plugin/koz-site-bridge/)

## Description

KOZ Site Bridge is an independently installable WordPress plugin developed and maintained
by Tony Kozyriev. It grew from production tooling used on the UA FREE charitable
foundation website.

#### Part of the KOZ Suite

KOZ Site Bridge is **one focused module of the broader KOZ Suite**, a family of 
independent WordPress plugins that share a common KOZ administration experience 
and visual identity.

Each KOZ plugin remains independently installable, so site owners can use only the
modules they need or combine several modules into one toolkit.

Current public KOZ plugins:

 * [KOZ SEO Core](https://wordpress.org/plugins/koz-seo-core/) — technical SEO, 
   schema, sitemaps, AI discovery and OpenAI Vision image ALT.
 * [KOZ Copy Actions](https://wordpress.org/plugins/koz-copy-actions/) — accessible
   copy-to-clipboard actions for selected WordPress content.
 * [KOZ URL-Only Comment Spam](https://wordpress.org/plugins/koz-url-only-comment-spam/)—
   privacy-first local moderation for URL-only comment spam.
 * [KOZ Static Translate](https://wordpress.org/plugins/koz-static-translate/) —
   AI-powered multilingual translation with Microsoft Azure AI Translator and static
   language routes.
 * [KOZ Translate Diagnostics](https://wordpress.org/plugins/koz-translate-diagnostics/)—
   read-only health checks and privacy-safe diagnostic reports for KOZ Static Translate.
 * [KOZ 404 Guard & URL Intelligence](https://wordpress.org/plugins/koz-404-guard/)—
   privacy-safe 404/410 diagnostics, controlled same-site redirects and URL intelligence.
 * [KOZ Consent Manager](https://wordpress.org/plugins/koz-consent-manager/) — privacy-
   first visitor consent, optional script control and Google Consent Mode v2 synchronization.
 * [KOZ Donate Stats & Conversions](https://wordpress.org/plugins/koz-donate-stats/)—
   local donation-journey analytics and consent-aware conversion events for WordPress.
 * KOZ Site Bridge — secure read-only WordPress diagnostics, controlled same-site
   probes and authenticated REST automation.

#### Main features

 * authenticated read-only REST diagnostics;
 * several API keys, each with a label, access scopes (basic, content, audits, 404
   log, PHP error log), last-used date and optional expiry;
 * “Try it” console in the admin: run any endpoint as an administrator without a
   key and see the JSON;
 * WordPress 6.9+ Abilities API: read-only abilities for administrators that AI 
   clients can use through the MCP Adapter;
 * sitemaps from robots.txt (for example multilingual sitemaps) are included in 
   the inventory and audits, with counts per language;
 * KOZ 404 Guard 2.2+ log with paths (when the log stores them), query keys and 
   same-site referrers;
 * security headers, page/CDN cache and response-time, and consent (trackers, embeds,
   Consent Mode) checks;
 * status of KOZ plugins: 404 Guard, Donate Stats, Static Translate (with monthly
   Azure usage) and Consent Manager;
 * Site Health test for HTTPS, old non-expiring keys and error-log access;
 * canonical KOZ REST namespace and X-KOZ-Key authentication;
 * backward-compatible legacy endpoint and header during migration;
 * HMAC API keys with one-time display;
 * no persistent API request log, IP storage or User-Agent storage;
 * safe same-site public frontend HTTP probes without query strings;
 * allowlisted Googlebot and AdsBot User-Agent profiles;
 * redirect-chain and selected Cloudflare/server headers;
 * rendered public-page audit for title, description, canonical, robots, hreflang,
   headings, image alt state, links, schema and document language;
 * sitemap inventory and batched sitemap audit with concrete per-URL findings;
 * privacy-safe KOZ 404 Guard integration;
 * KOZ Suite inventory and navigation;
 * multilingual administration with English fallback;
 * no arbitrary URL input and no content, plugin, theme or user modifications.

Existing Site Bridge API keys are preserved. The old REST namespace and X-UAFree-
Key header remain accepted during migration, while new integrations should use /
wp-json/kozbridge/v1 and X-KOZ-Key. The previous /wp-json/koz-site-bridge/v1 route
also remains available.

#### Access and security

 * The X-KOZ-Key is generated locally by the site administrator and is used only
   to authenticate the read-only REST API. It does not control feature availability.
 * Every built-in plugin feature is available to every installation.
 * Each key can be limited to the scopes it needs; reading the PHP error log is 
   off for new keys. The key created before 0.6.0 is kept as “Legacy key” with full
   access until you revoke it.
 * Abilities and the “Try it” console require the manage_options capability and 
   never use or show API keys.
 * The authenticated API has a security/abuse throttle of 120 successful requests
   per hour per key. This protects the WordPress site and applies equally to all
   authenticated clients.
 * The OpenAPI schema endpoint is intentionally public so an administrator can import
   the schema into a REST client. It exposes only the API contract and does not 
   return private site data, credentials, settings, content, or logs. All diagnostic
   data endpoints require X-KOZ-Key authentication.
 * KOZ Site Bridge does not connect to an external processing service. Its HTTP 
   probes are restricted to the current WordPress site. External REST clients or
   automation tools are optional and chosen by the site administrator.

## Installation

 1. If the legacy UA FREE Site Bridge plugin is active, deactivate it manually and 
    keep it installed until verification is complete. KOZ Site Bridge does not deactivate
    other plugins automatically.
 2. Upload and activate the KOZ plugin ZIP.
 3. Open KOZ Suite > Site Bridge.
 4. Create an API key with the scopes you need, then test Ping and OpenAPI, or use 
    the “Try it” console.

## FAQ

### Do I need to change my existing GPT after updating?

No. The key created before 0.6.0 keeps working as “Legacy key” with full access.
You can later create a key with fewer scopes, put it into the GPT and revoke the
legacy key.

### How do AI clients use the abilities?

On WordPress 6.9 or newer the plugin registers read-only abilities (site overview,
diagnostics, page audit, sitemap audit, 404 log, plugins) in the “KOZ Site Bridge”
category. Only administrators can run them. Install the WordPress MCP Adapter to
expose them to an MCP client. You can turn them off in the settings.

### What does the plugin store?

Key digests (HMAC-SHA256), labels, scopes, creation, last-used and expiry dates,
one settings option and hourly rate-limit counters that expire automatically. No
IP addresses, User-Agent strings or request history.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“KOZ Site Bridge” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Tony_Koz ](https://profiles.wordpress.org/ramirkz/)

[Translate “KOZ Site Bridge” into your language.](https://translate.wordpress.org/projects/wp-plugins/koz-site-bridge)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/koz-site-bridge/), 
check out the [SVN repository](https://plugins.svn.wordpress.org/koz-site-bridge/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/koz-site-bridge/)
by [RSS](https://plugins.trac.wordpress.org/log/koz-site-bridge/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.6.0

 * Several API keys with label, scopes, last-used date and optional expiry; the 
   existing key stays as “Legacy key” with full access.
 * Scoped REST permissions: a key without the scope gets HTTP 403.
 * “Try it” console in the admin (administrators only, no key).
 * Read-only Abilities API abilities for administrators (WordPress 6.9+, MCP Adapter).
 * /404-log reads the KOZ 404 Guard 2.2 table (paths, query keys, same-site referrers)
   with the old option as a fallback.
 * Sitemaps declared in robots.txt are included in /sitemap, /rendered-audit and/
   diagnostics; /sitemap reports counts per sitemap and language.
 * New endpoints: /security-headers, /performance, /consent-check.
 * /suite reports the status of KOZ 404 Guard, Donate Stats, Static Translate (including
   Azure usage) and Consent Manager.
 * OpenAPI: new operations, response schemas and the 403 response.
 * Site Health test and debug information.
 * Code split into Auth, Admin, Abilities and Site Health classes.
 * Support panel: PayPal removed, crypto addresses updated.

#### 0.5.7

 * Removed automatic deactivation of the legacy UA FREE Site Bridge plugin; activation
   state remains under administrator control.
 * Replaced the generic public REST permission callback on the OpenAPI schema with
   an explicit plugin callback documenting the intentionally public, schema-only
   endpoint.
 * Clarified that X-KOZ-Key is a local authentication credential, does not control
   feature availability, and that the hourly request throttle is security/abuse 
   protection only.
 * No diagnostic endpoint was made public; all site-data endpoints remain authenticated.

#### 0.5.6

 * Updated WordPress compatibility metadata for WordPress 7.1.
 * No functional or API behavior changes.

#### 0.5.5

 * Replaced direct PHP log file handles with the WordPress Filesystem API for Plugin
   Check compliance.
 * Preserved the read-only admin error-log endpoint, fixed candidate allowlist and
   privacy redaction.
 * No changes to API keys, routes or existing diagnostics behavior.

#### 0.5.4

 * Added an authenticated read-only admin error-log diagnostic endpoint for private
   troubleshooting.
 * Reads only fixed WordPress/PHP log candidates, never an arbitrary path supplied
   by the caller.
 * Redacts credentials, cookies, email addresses and local filesystem prefixes before
   returning recent log lines.
 * Preserved all existing Site Bridge endpoints, API-key compatibility and read-
   only behavior.

#### 0.5.3

 * Added rendered public-page audit and sitemap inventory/batch audit.
 * Expanded probes to safe public frontend routes while keeping WordPress administration,
   REST, login and executable paths blocked.
 * Added DOM-independent parsing fallback and preserved the read-only/privacy-safe
   contract.

#### 0.5.2

 * Fixed KOZ Suite submenu registration so the existing Site Bridge admin URL remains
   accessible when another KOZ plugin owns the suite menu.
 * Removed a duplicate Site Bridge catalog entry.

#### 0.5.1

 * WordPress.org strict prefix re-audit with canonical `kozbridge / KOZBRIDGE` identifiers.
 * Existing API-key options migrate automatically without deleting historical values.
 * Added canonical `/wp-json/kozbridge/v1` routes while preserving both earlier 
   REST namespaces.
 * Plugin-specific runtime, suite fallback, admin assets and support identifiers.

#### 0.5.0

 * Rebranded as KOZ Site Bridge.
 * Added KOZ Suite integration and multilingual administration.
 * Added canonical KOZ REST namespace and X-KOZ-Key authentication.
 * Preserved legacy API keys, endpoint and header compatibility.
 * Replaced site-specific probe paths with a generic safe allowlist.
 * Added a dedicated enqueued admin interface and shared KOZ support panel.

## Meta

 *  Version **0.6.0**
 *  Last updated **18 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.2 or higher **
 *  Tested up to **7.1.3**
 *  PHP version ** 8.0 or higher **
 * Tags
 * [diagnostics](https://wordpress.org/plugins/tags/diagnostics/)[mcp](https://wordpress.org/plugins/tags/mcp/)
   [rest-api](https://wordpress.org/plugins/tags/rest-api/)[seo audit](https://wordpress.org/plugins/tags/seo-audit/)
 *  [Advanced View](https://wordpress.org/plugins/koz-site-bridge/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/koz-site-bridge/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/koz-site-bridge/reviews/)

## Contributors

 *   [ Tony_Koz ](https://profiles.wordpress.org/ramirkz/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/koz-site-bridge/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://github.com/ramirkoz/ua-free-plugins)