WordPress
Connects to the WordPress REST API for managing posts, pages, and categories on a self-hosted or WordPress.com site. An agent can create, read, update, list, and delete posts/pages, and list categories.
Add to an agent node's tools array with _node_type: "tool-wordpress". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
url | Yes (or site_url) | Site URL, e.g. https://example.com. The connector appends /wp-json/wp/v2. |
site_url | Fallback | Used if url is not set. |
username | Yes | WordPress username, used for HTTP Basic auth. |
application_password | Yes (or password / api_key) | WordPress application password, used for HTTP Basic auth. |
password | Fallback | Used if application_password is not set. |
api_key | Fallback | Used if neither application_password nor password is set. |
{
"name": "wordpress",
"_node_type": "tool-wordpress",
"url": "https://example.com",
"username": "{{ secret.WORDPRESS_USERNAME }}",
"application_password": "{{ secret.WORDPRESS_APP_PASSWORD }}"
}
Tools
wordpress_create_post
Create a WordPress post or page.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Post title |
content | string | Yes | Post content (HTML) |
status | string | No | Post status: draft, publish, private (default: draft) |
type | string | No | Post type: post, page (default: post) |
categories | string | No | Comma-separated category IDs |
tags | string | No | Comma-separated tag IDs |
slug | string | No | URL slug |
excerpt | string | No | Post excerpt |
Returns: A confirmation message with the new post's ID, title and link.
wordpress_get_post
Get a WordPress post or page by ID.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
post_id | string | Yes | Post ID |
type | string | No | post|page (default: post) |
Returns: The raw JSON response for the post or page.
wordpress_update_post
Update a WordPress post.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
post_id | string | Yes | Post ID |
title | string | No | New title |
content | string | No | New content |
status | string | No | New status |
Returns: A confirmation message with the post's ID and updated status.
wordpress_list_posts
List WordPress posts or pages.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | No | post|page (default: post) |
status | string | No | any|draft|publish|private (default: publish) |
per_page | number | No | Items per page (default 10) |
page | number | No | Page number (default 1) |
search | string | No | Search keyword |
Returns: A count line followed by a newline-separated list of [id] title (status) lines.
wordpress_delete_post
Delete or trash a WordPress post.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
post_id | string | Yes | Post ID |
force | boolean | No | Skip trash and permanently delete |
Returns: A confirmation message that the post was deleted.
wordpress_list_categories
List WordPress categories.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
per_page | number | No | Items per page (default 100) |
Returns: A newline-separated list of [id] name (count: N) lines.