@mangerik/wordpress-mcp 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +11 -0
- package/README.md +13 -8
- package/docs/TOOLS.md +1458 -0
- package/docs/USAGE.md +211 -0
- package/package.json +4 -2
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [0.1.1] - 2026-05-17
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
- `docs/USAGE.md` — bilingual (Indonesian + English) prompt examples covering
|
|
12
|
+
authoring, audit, WooCommerce, SEO, block themes, batch, and multisite.
|
|
13
|
+
- `docs/TOOLS.md` — auto-generated reference for all 96 tools, complete with
|
|
14
|
+
argument tables, types, and read-only / destructive hints.
|
|
15
|
+
- `npm run docs` script that regenerates `docs/TOOLS.md` from the running
|
|
16
|
+
server (also runs automatically before publish).
|
|
17
|
+
- `docs/` is now shipped in the npm tarball.
|
|
18
|
+
|
|
8
19
|
## [0.1.0] - 2026-05-17
|
|
9
20
|
|
|
10
21
|
Initial public preview. Tagged `beta` on npm while we collect feedback from
|
package/README.md
CHANGED
|
@@ -225,6 +225,19 @@ Both plugins store SEO data in post meta with different keys; one uniform tool r
|
|
|
225
225
|
### JWT diagnostics (only in JWT mode)
|
|
226
226
|
- `wp_jwt_validate` — validate the active token via `/jwt-auth/v1/token/validate`.
|
|
227
227
|
|
|
228
|
+
## Documentation
|
|
229
|
+
|
|
230
|
+
- 📖 **[USAGE.md](docs/USAGE.md)** — Real-world prompt examples (Indonesian + English): authoring, audit, WooCommerce, SEO, batch, multisite, etc.
|
|
231
|
+
- 📚 **[TOOLS.md](docs/TOOLS.md)** — Full reference for all 96 tools with arguments, types, and hints. Auto-generated from the running server.
|
|
232
|
+
|
|
233
|
+
## Notes & gotchas
|
|
234
|
+
|
|
235
|
+
- **`status` defaults to `draft`** for `wp_create_post` / `wp_create_page`. Override explicitly if you really want to publish.
|
|
236
|
+
- **Custom fields (`meta`)** must be registered server-side with `register_post_meta(..., 'show_in_rest' => true)` to be writable through REST.
|
|
237
|
+
- **Use `_fields`** to slim responses — e.g. `_fields: "id,title,slug"` cuts response size by ~80% for list calls.
|
|
238
|
+
- **`context=edit`** is required to receive raw (unfiltered) content for round-tripping through `wp_update_post`.
|
|
239
|
+
- The server logs to **stderr only**. Stdout is reserved for JSON-RPC framing.
|
|
240
|
+
|
|
228
241
|
## Resources
|
|
229
242
|
|
|
230
243
|
| URI | What |
|
|
@@ -243,14 +256,6 @@ Both plugins store SEO data in post meta with different keys; one uniform tool r
|
|
|
243
256
|
| `translate_page` | `page_id`, `target_language`, `create_new?` |
|
|
244
257
|
| `draft_post` | `topic`, `tone?`, `word_count?` |
|
|
245
258
|
|
|
246
|
-
## Notes & gotchas
|
|
247
|
-
|
|
248
|
-
- **`status` defaults to `draft`** for `wp_create_post` / `wp_create_page`. Override explicitly if you really want to publish.
|
|
249
|
-
- **Custom fields (`meta`)** must be registered server-side with `register_post_meta(..., 'show_in_rest' => true)` to be writable through REST.
|
|
250
|
-
- **Use `_fields`** to slim responses — e.g. `_fields: "id,title,slug"` cuts response size by ~80% for list calls.
|
|
251
|
-
- **`context=edit`** is required to receive raw (unfiltered) content for round-tripping through `wp_update_post`.
|
|
252
|
-
- The server logs to **stderr only**. Stdout is reserved for JSON-RPC framing.
|
|
253
|
-
|
|
254
259
|
## License
|
|
255
260
|
|
|
256
261
|
MIT
|