# Goldnat for WordPress

A WordPress plugin that exposes your site as an AI-accessible tool server via the Servio protocol. Let ChatGPT, Claude, Copilot, Gemini, and other AI agents securely interact with your content through OAuth 2.0 with PKCE.

- Platform: WordPress
- Edition: free
- Web page: https://plugins.goldnat.ai/wordpress/wordpress-plugin
- Installation guide: https://plugins.goldnat.ai/wordpress/guide

## What it does

- **REST API Integration** — Built on the WordPress REST API. Zero configuration required — works with any standard WordPress installation.
- **Servio Protocol** — Built on the Servio Protocol standard for tool-use AI agents. Provides a manifest endpoint, tool discovery, and structured JSON responses that AI platforms understand natively.
- **Pre-configured AI Clients** — Ships with built-in OAuth client configurations for ChatGPT, Claude, Copilot, Gemini, Grok, DeepSeek, and Perplexity. Connect in minutes, not hours.
- **Built for WordPress 5.8+** — Native WordPress plugin with proper activation hooks, REST routes, and admin settings. Installs through the standard plugin manager — no file editing required.
- **Secure by design** — Industry-standard OAuth flow with PKCE. Every AI agent authenticates with proof-of-key exchange — no secrets stored client-side.
- **Native permissions** — Tool calls respect the platform's native permission model. Users only see content they're allowed to access.
- **Servio Protocol** — Manifest endpoint, tool discovery, structured JSON responses. Compatible with the Model Context Protocol standard.
- **Production ready** — Structured tool calls ready for production use on your platform.

## What you can ask the agent

- "Which of my posts mention "pricing"?" — The agent searches your posts and pages and lists the matches with links.
- "Summarize my last ten blog posts." — It reads the latest posts and gives you a short summary of each.
- "Which categories and tags do I actually use?" — It lists your categories and tags so you can spot duplicates and empty ones.
- "Show me the comments that came in this week." — It lists recent comments with the post each one belongs to.
- "Find the images I uploaded for the spring campaign." — It searches your media library by name and returns the files.
- "What does my site menu look like?" — It reads your menus and shows the structure.

## Install and connect

1. Install Goldnat for WordPress from the official store: https://wordpress.org/plugins/goldt-webmcp-bridge/
2. Connect your AI agent: in goldnat.ai (or another compatible agent) add your site address. You are sent to your own WordPress site to log in and approve what the agent may do (read only, or read and write).
3. Ask the agent in plain language. It calls the plugin on your site as you, and shows you the result.
4. Full installation guide with screenshots: https://plugins.goldnat.ai/wordpress/guide

## What the agent can and cannot do

- The agent acts as the WordPress user who connected it. It can never see or change more than that user can.
- You approve the access level when you connect (read only, or read and write), and you can revoke the connection at any time from the plugin page in your admin panel.
- This plugin is read-only: the agent can look things up and summarise, but cannot create, change or delete anything.
- Your content stays on your site. The plugin answers the agent's requests directly; it does not copy your site anywhere else.

## Tools

Each tool is called by the agent by name. "write" tools need write access approved at connection.

- `wordpress.getCategories` (read) — Fetch all category taxonomies with names, descriptions, post counts and hierarchy.
- `wordpress.getComments` (read) — Fetch comments filtered by post, page, author or status. Returns content, date, author and approval state.
- `wordpress.getCurrentUser` (read) — Returns the currently authenticated user.
- `wordpress.getMedia` (read) — Get details of a media item (image, video, PDF) by ID: URL, title, description, alt text, size, MIME type.
- `wordpress.getMenus` (read) — Fetch all site menus with hierarchical structure, links, labels and locations.
- `wordpress.getPage` (read) — Returns a single page by ID.
- `wordpress.getPost` (read) — Returns a single post by ID.
- `wordpress.getPostTypes` (read) — List all registered post types including custom ones: names, labels, capabilities and available statuses.
- `wordpress.getSiteInfo` (read) — Get general site info: name, description, URL, language, timezone, date format, WordPress version.
- `wordpress.getSiteSettings` (read) — Get site settings: title, tagline, admin email, timezone, default category, discussion settings.
- `wordpress.getTags` (read) — Fetch all tag taxonomies with names, descriptions and post counts.
- `wordpress.getTaxonomies` (read) — List all taxonomies including custom ones: names, labels, associated post types and hierarchy.
- `wordpress.getUsers` (read) — List users by role, name search and count. Returns names, emails, roles and post counts.
- `wordpress.listCategories` (read) — List post categories. Use search (matches name OR slug, case-insensitive substring) to resolve a category id from its name/slug — the common pre-step for createPost.
- `wordpress.listComments` (read) — Alias for getComments — enumerate all comments across the site with filters. With post_id the answer carries the exact total and has_more for paging (offset/per_page, order=asc for reading order).
- `wordpress.listMedia` (read) — List media library items with filters (mime_type, upload date, author). Returns URLs and metadata.
- `wordpress.listPages` (read) — List pages with filters (status, parent hierarchy, date, per_page). Returns metadata + total count.
- `wordpress.listPosts` (read) — List posts with filters (status, category, date, author, per_page). Returns metadata + total count.
- `wordpress.listTags` (read) — List post tags. Use search (matches name OR slug, case-insensitive substring) to resolve a tag id from its name/slug — the common pre-step for createPost.
- `wordpress.searchMedia` (read) — Search media items by name, title, description, MIME type, upload date. Returns files with URLs and available sizes.
- `wordpress.searchPages` (read) — Searches pages by keywords.
- `wordpress.searchPosts` (read) — Searches posts by keywords.

## Frequently asked questions

**Which AI agents can I use?**

Our own agent at goldnat.ai, and other AI agents that support the Servio protocol. The list of compatible clients is on this page.

**Can the AI see or change things I can't?**

No. It works as the WordPress user who connected it, with exactly that user's permissions. Connect it with an account that has only the access you want it to have.

**Will it change things without asking?**

No. This plugin is read-only.

**How do I disconnect an agent?**

Revoke its connection from the plugin page in your admin panel. The agent loses access immediately.

## Guides

- [Managing Many WordPress Sites with an AI Agent](https://plugins.goldnat.ai/docs/06-managing-many-wordpress-sites) — A practical guide for agencies and freelancers who look after several WordPress sites — how to connect one AI agent to all of them with the Goldnat plugins, what it can check and change on each site, how permissions and confirmations keep it safe, and a weekly routine you can copy.
