mcp-wordpress 2.10.0 → 2.10.2
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/README.md +17 -19
- package/bin/mcp-wordpress.js +3 -3
- package/bin/setup.js +140 -141
- package/bin/status.js +112 -114
- package/dist/client/MockWordPressClient.d.ts.map +1 -1
- package/dist/client/MockWordPressClient.js.map +1 -1
- package/dist/client/SEOWordPressClient.d.ts.map +1 -1
- package/dist/client/SEOWordPressClient.js +16 -14
- package/dist/client/SEOWordPressClient.js.map +1 -1
- package/dist/client/index.d.ts +6 -6
- package/dist/client/index.js +6 -6
- package/dist/client/managers/AuthManager.d.ts.map +1 -1
- package/dist/client/managers/AuthManager.js +2 -2
- package/dist/client/managers/AuthManager.js.map +1 -1
- package/dist/client/managers/AuthenticationManager.js +1 -1
- package/dist/client/managers/JWTAuthImplementation.d.ts.map +1 -1
- package/dist/client/managers/JWTAuthImplementation.js +7 -7
- package/dist/client/managers/JWTAuthImplementation.js.map +1 -1
- package/dist/client/managers/composed/MigrationAdapter.js +1 -1
- package/dist/client/managers/composed/index.d.ts +2 -2
- package/dist/client/managers/composed/index.d.ts.map +1 -1
- package/dist/client/managers/composed/index.js +1 -1
- package/dist/client/managers/composed/index.js.map +1 -1
- package/dist/client/managers/implementations/ErrorHandlerImpl.d.ts.map +1 -1
- package/dist/client/managers/implementations/ErrorHandlerImpl.js +2 -4
- package/dist/client/managers/implementations/ErrorHandlerImpl.js.map +1 -1
- package/dist/client/managers/implementations/ParameterValidatorImpl.d.ts.map +1 -1
- package/dist/client/managers/implementations/ParameterValidatorImpl.js +1 -1
- package/dist/client/managers/implementations/ParameterValidatorImpl.js.map +1 -1
- package/dist/client/managers/interfaces/ManagerInterfaces.d.ts.map +1 -1
- package/dist/config/index.d.ts +3 -3
- package/dist/config/index.js +3 -3
- package/dist/docs/MarkdownFormatter.d.ts.map +1 -1
- package/dist/docs/MarkdownFormatter.js +7 -7
- package/dist/docs/MarkdownFormatter.js.map +1 -1
- package/dist/performance/PerformanceAnalytics.d.ts.map +1 -1
- package/dist/performance/PerformanceAnalytics.js +3 -1
- package/dist/performance/PerformanceAnalytics.js.map +1 -1
- package/dist/security/InputValidator.js +1 -1
- package/dist/security/SecurityCIPipeline.js +1 -1
- package/dist/security/SecurityCIPipeline.js.map +1 -1
- package/dist/security/SecurityConfig.d.ts.map +1 -1
- package/dist/security/SecurityConfig.js +6 -2
- package/dist/security/SecurityConfig.js.map +1 -1
- package/dist/server/index.d.ts +2 -2
- package/dist/server/index.js +2 -2
- package/dist/tools/cache.d.ts.map +1 -1
- package/dist/tools/cache.js.map +1 -1
- package/dist/tools/comments.d.ts.map +1 -1
- package/dist/tools/comments.js.map +1 -1
- package/dist/tools/performance.d.ts.map +1 -1
- package/dist/tools/performance.js.map +1 -1
- package/dist/tools/posts/PostHandlers.d.ts.map +1 -1
- package/dist/tools/posts/PostHandlers.js.map +1 -1
- package/dist/tools/seo/SEOTools.d.ts.map +1 -1
- package/dist/tools/seo/SEOTools.js.map +1 -1
- package/dist/tools/seo/analyzers/ContentAnalyzer.d.ts.map +1 -1
- package/dist/tools/seo/analyzers/ContentAnalyzer.js.map +1 -1
- package/dist/types/enhanced.d.ts +17 -17
- package/dist/types/enhanced.d.ts.map +1 -1
- package/dist/types/enhanced.js +2 -2
- package/dist/types/index.d.ts +2 -2
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/requests.d.ts +16 -16
- package/dist/types/tools.d.ts +46 -46
- package/dist/types/tools.d.ts.map +1 -1
- package/dist/utils/index.d.ts +7 -7
- package/dist/utils/index.js +7 -7
- package/docs/ARCHITECTURE.md +17 -17
- package/docs/BADGE_UPDATES.md +11 -11
- package/docs/CACHING.md +2 -0
- package/docs/CI_CD_IMPROVEMENTS.md +8 -5
- package/docs/CONFIGURATION.md +76 -46
- package/docs/DOCKER_PUBLISHING_TROUBLESHOOTING.md +11 -2
- package/docs/EVALUATION.md +16 -21
- package/docs/INCREMENTAL_COVERAGE.md +7 -3
- package/docs/INSTALLATION.md +33 -19
- package/docs/PUBLISHING-TROUBLESHOOTING.md +3 -2
- package/docs/SECURITY.md +17 -15
- package/docs/SECURITY_TESTING.md +3 -0
- package/docs/TROUBLESHOOTING.md +85 -36
- package/docs/api/README.md +118 -125
- package/docs/api/categories/auth.md +3 -1
- package/docs/api/categories/cache.md +3 -1
- package/docs/api/categories/comment.md +3 -1
- package/docs/api/categories/media.md +3 -1
- package/docs/api/categories/page.md +3 -1
- package/docs/api/categories/performance.md +3 -1
- package/docs/api/categories/post.md +3 -1
- package/docs/api/categories/site.md +3 -1
- package/docs/api/categories/taxonomy.md +3 -1
- package/docs/api/categories/user.md +3 -1
- package/docs/api/openapi.json +114 -410
- package/docs/api/summary.json +1 -1
- package/docs/api/tools/wp_approve_comment.md +13 -25
- package/docs/api/tools/wp_cache_clear.md +17 -30
- package/docs/api/tools/wp_cache_info.md +16 -29
- package/docs/api/tools/wp_cache_stats.md +16 -29
- package/docs/api/tools/wp_cache_warm.md +16 -29
- package/docs/api/tools/wp_create_application_password.md +14 -26
- package/docs/api/tools/wp_create_category.md +14 -26
- package/docs/api/tools/wp_create_comment.md +18 -31
- package/docs/api/tools/wp_create_page.md +17 -29
- package/docs/api/tools/wp_create_post.md +25 -30
- package/docs/api/tools/wp_create_tag.md +13 -25
- package/docs/api/tools/wp_create_user.md +18 -30
- package/docs/api/tools/wp_delete_application_password.md +14 -26
- package/docs/api/tools/wp_delete_category.md +13 -25
- package/docs/api/tools/wp_delete_comment.md +14 -26
- package/docs/api/tools/wp_delete_media.md +14 -25
- package/docs/api/tools/wp_delete_page.md +14 -25
- package/docs/api/tools/wp_delete_post.md +17 -25
- package/docs/api/tools/wp_delete_tag.md +13 -25
- package/docs/api/tools/wp_delete_user.md +14 -25
- package/docs/api/tools/wp_get_application_passwords.md +13 -25
- package/docs/api/tools/wp_get_auth_status.md +12 -24
- package/docs/api/tools/wp_get_category.md +13 -25
- package/docs/api/tools/wp_get_comment.md +13 -25
- package/docs/api/tools/wp_get_current_user.md +17 -30
- package/docs/api/tools/wp_get_media.md +13 -25
- package/docs/api/tools/wp_get_page.md +13 -25
- package/docs/api/tools/wp_get_page_revisions.md +13 -25
- package/docs/api/tools/wp_get_post.md +16 -25
- package/docs/api/tools/wp_get_post_revisions.md +13 -25
- package/docs/api/tools/wp_get_site_settings.md +12 -23
- package/docs/api/tools/wp_get_tag.md +13 -25
- package/docs/api/tools/wp_get_user.md +13 -25
- package/docs/api/tools/wp_list_categories.md +15 -27
- package/docs/api/tools/wp_list_comments.md +15 -27
- package/docs/api/tools/wp_list_media.md +18 -31
- package/docs/api/tools/wp_list_pages.md +18 -31
- package/docs/api/tools/wp_list_posts.md +29 -41
- package/docs/api/tools/wp_list_tags.md +14 -26
- package/docs/api/tools/wp_list_users.md +20 -34
- package/docs/api/tools/wp_performance_alerts.md +22 -36
- package/docs/api/tools/wp_performance_benchmark.md +20 -34
- package/docs/api/tools/wp_performance_export.md +22 -36
- package/docs/api/tools/wp_performance_history.md +21 -35
- package/docs/api/tools/wp_performance_optimize.md +22 -36
- package/docs/api/tools/wp_performance_stats.md +20 -34
- package/docs/api/tools/wp_search_site.md +18 -32
- package/docs/api/tools/wp_spam_comment.md +13 -25
- package/docs/api/tools/wp_switch_auth_method.md +18 -31
- package/docs/api/tools/wp_test_auth.md +15 -30
- package/docs/api/tools/wp_update_category.md +14 -26
- package/docs/api/tools/wp_update_comment.md +17 -30
- package/docs/api/tools/wp_update_media.md +19 -32
- package/docs/api/tools/wp_update_page.md +18 -30
- package/docs/api/tools/wp_update_post.md +21 -30
- package/docs/api/tools/wp_update_site_settings.md +18 -31
- package/docs/api/tools/wp_update_tag.md +14 -26
- package/docs/api/tools/wp_update_user.md +17 -29
- package/docs/api/tools/wp_upload_media.md +20 -32
- package/docs/api/types/WordPressPost.md +8 -15
- package/docs/code-improvements.md +1 -0
- package/docs/developer/GITHUB_ACTIONS_SETUP.md +2 -2
- package/docs/developer/MAINTENANCE.md +4 -0
- package/docs/developer/NPM_AUTH_SETUP.md +3 -0
- package/docs/developer/RELEASE_PROCESS.md +1 -0
- package/docs/examples/multi-site-setup.md +2 -0
- package/docs/integrations/claude-desktop.md +14 -5
- package/docs/integrations/cline.md +1 -0
- package/docs/user-guides/DTX_SETUP.md +9 -8
- package/docs/user-guides/NPX_SETUP.md +5 -9
- package/docs/user-guides/SMITHERY_SETUP.md +5 -0
- package/docs/v2.2.0-resolution-demo.md +17 -2
- package/package.json +2 -1
- package/src/cache/__tests__/CacheManager.test.ts +4 -8
- package/src/client/MockWordPressClient.ts +5 -1
- package/src/client/SEOWordPressClient.ts +30 -26
- package/src/client/index.ts +6 -6
- package/src/client/managers/AuthManager.ts +16 -8
- package/src/client/managers/AuthenticationManager.ts +2 -2
- package/src/client/managers/JWTAuthImplementation.ts +24 -27
- package/src/client/managers/ManagersIndex.ts +1 -1
- package/src/client/managers/composed/MigrationAdapter.ts +1 -1
- package/src/client/managers/composed/index.ts +7 -7
- package/src/client/managers/implementations/ErrorHandlerImpl.ts +12 -26
- package/src/client/managers/implementations/ParameterValidatorImpl.ts +49 -49
- package/src/client/managers/interfaces/ManagerInterfaces.ts +13 -9
- package/src/config/index.ts +3 -3
- package/src/docs/MarkdownFormatter.ts +13 -9
- package/src/performance/PerformanceAnalytics.ts +9 -3
- package/src/security/InputValidator.ts +1 -1
- package/src/security/SecurityCIPipeline.ts +1 -1
- package/src/security/SecurityConfig.ts +9 -3
- package/src/server/index.ts +2 -2
- package/src/tools/cache.ts +3 -1
- package/src/tools/comments.ts +3 -1
- package/src/tools/performance.ts +7 -3
- package/src/tools/posts/PostHandlers.ts +3 -1
- package/src/tools/seo/SEOTools.ts +6 -2
- package/src/tools/seo/analyzers/ContentAnalyzer.ts +9 -3
- package/src/types/enhanced.ts +34 -34
- package/src/types/index.ts +13 -11
- package/src/types/requests.ts +19 -19
- package/src/types/tools.ts +137 -84
- package/src/utils/index.ts +7 -7
|
@@ -6,10 +6,10 @@ Creates a new category.
|
|
|
6
6
|
|
|
7
7
|
## Parameters
|
|
8
8
|
|
|
9
|
-
| Parameter
|
|
10
|
-
|
|
11
|
-
| `name`
|
|
12
|
-
| `description` | `string` | ❌
|
|
9
|
+
| Parameter | Type | Required | Description | Default | Examples |
|
|
10
|
+
| ------------- | -------- | -------- | --------------------------------- | ------- | --------- |
|
|
11
|
+
| `name` | `string` | ✅ | The name of the category. | - | `example` |
|
|
12
|
+
| `description` | `string` | ❌ | The description for the category. | - | `example` |
|
|
13
13
|
|
|
14
14
|
## Examples
|
|
15
15
|
|
|
@@ -18,11 +18,13 @@ Creates a new category.
|
|
|
18
18
|
Simple example of using wp_create_category
|
|
19
19
|
|
|
20
20
|
**Command:**
|
|
21
|
+
|
|
21
22
|
```bash
|
|
22
23
|
wp_create_category --name="example_value"
|
|
23
24
|
```
|
|
24
25
|
|
|
25
26
|
**Response:**
|
|
27
|
+
|
|
26
28
|
```json
|
|
27
29
|
{
|
|
28
30
|
"success": true,
|
|
@@ -35,6 +37,7 @@ wp_create_category --name="example_value"
|
|
|
35
37
|
```
|
|
36
38
|
|
|
37
39
|
**Error Example (Authentication failure):**
|
|
40
|
+
|
|
38
41
|
```json
|
|
39
42
|
{
|
|
40
43
|
"error": "Authentication failed",
|
|
@@ -42,11 +45,6 @@ wp_create_category --name="example_value"
|
|
|
42
45
|
}
|
|
43
46
|
```
|
|
44
47
|
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
48
|
## Response Format
|
|
51
49
|
|
|
52
50
|
**Return Type:** `taxonomy`
|
|
@@ -69,34 +67,24 @@ wp_create_category --name="example_value"
|
|
|
69
67
|
|
|
70
68
|
### AUTHENTICATION_FAILED
|
|
71
69
|
|
|
72
|
-
**Message:** Authentication failed
|
|
73
|
-
|
|
74
|
-
**Resolution:** Check your authentication credentials and user permissions
|
|
75
|
-
|
|
70
|
+
**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
|
|
71
|
+
Check your authentication credentials and user permissions
|
|
76
72
|
|
|
77
73
|
### VALIDATION_ERROR
|
|
78
74
|
|
|
79
|
-
**Message:** Parameter validation failed
|
|
80
|
-
**Description:** One or more required parameters are missing or invalid
|
|
75
|
+
**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
|
|
81
76
|
**Resolution:** Review the required parameters and their formats
|
|
82
77
|
|
|
83
|
-
|
|
84
78
|
### NOT_FOUND
|
|
85
79
|
|
|
86
|
-
**Message:** Resource not found
|
|
87
|
-
|
|
88
|
-
**Resolution:** Verify the resource ID and ensure it exists
|
|
89
|
-
|
|
80
|
+
**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
|
|
81
|
+
resource ID and ensure it exists
|
|
90
82
|
|
|
91
83
|
### PERMISSION_DENIED
|
|
92
84
|
|
|
93
|
-
**Message:** Insufficient permissions
|
|
94
|
-
**Description:** The user does not have permission to perform this action
|
|
85
|
+
**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
|
|
95
86
|
**Resolution:** Contact an administrator to grant the necessary permissions
|
|
96
87
|
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
88
|
---
|
|
101
89
|
|
|
102
|
-
|
|
90
|
+
_Generated automatically from tool definitions - Do not edit manually_
|
|
@@ -6,12 +6,12 @@ Creates a new comment on a post.
|
|
|
6
6
|
|
|
7
7
|
## Parameters
|
|
8
8
|
|
|
9
|
-
| Parameter
|
|
10
|
-
|
|
11
|
-
| `post`
|
|
12
|
-
| `content`
|
|
13
|
-
| `author_name`
|
|
14
|
-
| `author_email` | `string` | ❌
|
|
9
|
+
| Parameter | Type | Required | Description | Default | Examples |
|
|
10
|
+
| -------------- | -------- | -------- | --------------------------------- | ------- | ----------------------------------------------------- |
|
|
11
|
+
| `post` | `number` | ✅ | The ID of the post to comment on. | - | `example` |
|
|
12
|
+
| `content` | `string` | ✅ | The content of the comment. | - | `<p>Post content here</p>`, `This is my post content` |
|
|
13
|
+
| `author_name` | `string` | ❌ | The name of the comment author. | - | `example` |
|
|
14
|
+
| `author_email` | `string` | ❌ | The email of the comment author. | - | `example` |
|
|
15
15
|
|
|
16
16
|
## Examples
|
|
17
17
|
|
|
@@ -20,11 +20,13 @@ Creates a new comment on a post.
|
|
|
20
20
|
Simple example of using wp_create_comment
|
|
21
21
|
|
|
22
22
|
**Command:**
|
|
23
|
+
|
|
23
24
|
```bash
|
|
24
25
|
wp_create_comment --post="example_value" --content="This is example content for the post."
|
|
25
26
|
```
|
|
26
27
|
|
|
27
28
|
**Response:**
|
|
29
|
+
|
|
28
30
|
```json
|
|
29
31
|
{
|
|
30
32
|
"success": true,
|
|
@@ -37,6 +39,7 @@ wp_create_comment --post="example_value" --content="This is example content for
|
|
|
37
39
|
```
|
|
38
40
|
|
|
39
41
|
**Error Example (Authentication failure):**
|
|
42
|
+
|
|
40
43
|
```json
|
|
41
44
|
{
|
|
42
45
|
"error": "Authentication failed",
|
|
@@ -44,17 +47,18 @@ wp_create_comment --post="example_value" --content="This is example content for
|
|
|
44
47
|
}
|
|
45
48
|
```
|
|
46
49
|
|
|
47
|
-
|
|
48
50
|
### Advanced comment Configuration
|
|
49
51
|
|
|
50
52
|
Comprehensive example using all available parameters
|
|
51
53
|
|
|
52
54
|
**Command:**
|
|
55
|
+
|
|
53
56
|
```bash
|
|
54
57
|
wp_create_comment --post="example_value" --content="This is example content for the post." --author_name="example_value" --author_email="example_value"
|
|
55
58
|
```
|
|
56
59
|
|
|
57
60
|
**Response:**
|
|
61
|
+
|
|
58
62
|
```json
|
|
59
63
|
{
|
|
60
64
|
"success": true,
|
|
@@ -66,13 +70,6 @@ wp_create_comment --post="example_value" --content="This is example content for
|
|
|
66
70
|
}
|
|
67
71
|
```
|
|
68
72
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
73
|
## Response Format
|
|
77
74
|
|
|
78
75
|
**Return Type:** `comment`
|
|
@@ -95,34 +92,24 @@ wp_create_comment --post="example_value" --content="This is example content for
|
|
|
95
92
|
|
|
96
93
|
### AUTHENTICATION_FAILED
|
|
97
94
|
|
|
98
|
-
**Message:** Authentication failed
|
|
99
|
-
|
|
100
|
-
**Resolution:** Check your authentication credentials and user permissions
|
|
101
|
-
|
|
95
|
+
**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
|
|
96
|
+
Check your authentication credentials and user permissions
|
|
102
97
|
|
|
103
98
|
### VALIDATION_ERROR
|
|
104
99
|
|
|
105
|
-
**Message:** Parameter validation failed
|
|
106
|
-
**Description:** One or more required parameters are missing or invalid
|
|
100
|
+
**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
|
|
107
101
|
**Resolution:** Review the required parameters and their formats
|
|
108
102
|
|
|
109
|
-
|
|
110
103
|
### NOT_FOUND
|
|
111
104
|
|
|
112
|
-
**Message:** Resource not found
|
|
113
|
-
|
|
114
|
-
**Resolution:** Verify the resource ID and ensure it exists
|
|
115
|
-
|
|
105
|
+
**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
|
|
106
|
+
resource ID and ensure it exists
|
|
116
107
|
|
|
117
108
|
### PERMISSION_DENIED
|
|
118
109
|
|
|
119
|
-
**Message:** Insufficient permissions
|
|
120
|
-
**Description:** The user does not have permission to perform this action
|
|
110
|
+
**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
|
|
121
111
|
**Resolution:** Contact an administrator to grant the necessary permissions
|
|
122
112
|
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
113
|
---
|
|
127
114
|
|
|
128
|
-
|
|
115
|
+
_Generated automatically from tool definitions - Do not edit manually_
|
|
@@ -6,11 +6,11 @@ Creates a new page.
|
|
|
6
6
|
|
|
7
7
|
## Parameters
|
|
8
8
|
|
|
9
|
-
| Parameter | Type
|
|
10
|
-
|
|
11
|
-
| `title`
|
|
12
|
-
| `content` | `string` | ❌
|
|
13
|
-
| `status`
|
|
9
|
+
| Parameter | Type | Required | Description | Default | Examples |
|
|
10
|
+
| --------- | -------- | -------- | ----------------------------------------- | --------- | ----------------------------------------------------- |
|
|
11
|
+
| `title` | `string` | ✅ | The title for the page. | - | `My Blog Post`, `Hello World` |
|
|
12
|
+
| `content` | `string` | ❌ | The content for the page, in HTML format. | - | `<p>Post content here</p>`, `This is my post content` |
|
|
13
|
+
| `status` | `string` | ❌ | The publishing status for the page. | `publish` | `example` |
|
|
14
14
|
|
|
15
15
|
## Examples
|
|
16
16
|
|
|
@@ -19,11 +19,13 @@ Creates a new page.
|
|
|
19
19
|
Simple example of using wp_create_page
|
|
20
20
|
|
|
21
21
|
**Command:**
|
|
22
|
+
|
|
22
23
|
```bash
|
|
23
24
|
wp_create_page --title="Example Post Title"
|
|
24
25
|
```
|
|
25
26
|
|
|
26
27
|
**Response:**
|
|
28
|
+
|
|
27
29
|
```json
|
|
28
30
|
{
|
|
29
31
|
"success": true,
|
|
@@ -36,6 +38,7 @@ wp_create_page --title="Example Post Title"
|
|
|
36
38
|
```
|
|
37
39
|
|
|
38
40
|
**Error Example (Authentication failure):**
|
|
41
|
+
|
|
39
42
|
```json
|
|
40
43
|
{
|
|
41
44
|
"error": "Authentication failed",
|
|
@@ -43,17 +46,18 @@ wp_create_page --title="Example Post Title"
|
|
|
43
46
|
}
|
|
44
47
|
```
|
|
45
48
|
|
|
46
|
-
|
|
47
49
|
### Advanced page Configuration
|
|
48
50
|
|
|
49
51
|
Comprehensive example using all available parameters
|
|
50
52
|
|
|
51
53
|
**Command:**
|
|
54
|
+
|
|
52
55
|
```bash
|
|
53
56
|
wp_create_page --title="Example Post Title" --content="This is example content for the post." --status="publish"
|
|
54
57
|
```
|
|
55
58
|
|
|
56
59
|
**Response:**
|
|
60
|
+
|
|
57
61
|
```json
|
|
58
62
|
{
|
|
59
63
|
"success": true,
|
|
@@ -65,11 +69,6 @@ wp_create_page --title="Example Post Title" --content="This is example content f
|
|
|
65
69
|
}
|
|
66
70
|
```
|
|
67
71
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
72
|
## Required Permissions
|
|
74
73
|
|
|
75
74
|
This tool requires the following WordPress user capabilities:
|
|
@@ -79,7 +78,6 @@ This tool requires the following WordPress user capabilities:
|
|
|
79
78
|
|
|
80
79
|
**Note:** The authenticated user must have these capabilities to successfully execute this tool.
|
|
81
80
|
|
|
82
|
-
|
|
83
81
|
## Response Format
|
|
84
82
|
|
|
85
83
|
**Return Type:** `page`
|
|
@@ -102,34 +100,24 @@ This tool requires the following WordPress user capabilities:
|
|
|
102
100
|
|
|
103
101
|
### AUTHENTICATION_FAILED
|
|
104
102
|
|
|
105
|
-
**Message:** Authentication failed
|
|
106
|
-
|
|
107
|
-
**Resolution:** Check your authentication credentials and user permissions
|
|
108
|
-
|
|
103
|
+
**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
|
|
104
|
+
Check your authentication credentials and user permissions
|
|
109
105
|
|
|
110
106
|
### VALIDATION_ERROR
|
|
111
107
|
|
|
112
|
-
**Message:** Parameter validation failed
|
|
113
|
-
**Description:** One or more required parameters are missing or invalid
|
|
108
|
+
**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
|
|
114
109
|
**Resolution:** Review the required parameters and their formats
|
|
115
110
|
|
|
116
|
-
|
|
117
111
|
### NOT_FOUND
|
|
118
112
|
|
|
119
|
-
**Message:** Resource not found
|
|
120
|
-
|
|
121
|
-
**Resolution:** Verify the resource ID and ensure it exists
|
|
122
|
-
|
|
113
|
+
**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
|
|
114
|
+
resource ID and ensure it exists
|
|
123
115
|
|
|
124
116
|
### PERMISSION_DENIED
|
|
125
117
|
|
|
126
|
-
**Message:** Insufficient permissions
|
|
127
|
-
**Description:** The user does not have permission to perform this action
|
|
118
|
+
**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
|
|
128
119
|
**Resolution:** Contact an administrator to grant the necessary permissions
|
|
129
120
|
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
121
|
---
|
|
134
122
|
|
|
135
|
-
|
|
123
|
+
_Generated automatically from tool definitions - Do not edit manually_
|
|
@@ -4,26 +4,25 @@
|
|
|
4
4
|
|
|
5
5
|
Creates a new WordPress post with comprehensive validation and detailed success feedback including management links.
|
|
6
6
|
|
|
7
|
-
**Usage Examples:**
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
• Complete post: `wp_create_post --title="Complete Post" --content="<p>Content</p>" --excerpt="Summary" --status="publish"`
|
|
7
|
+
**Usage Examples:** • Simple post: `wp_create_post --title="My New Post" --content="<p>Hello World!</p>"` • Draft post:
|
|
8
|
+
`wp_create_post --title="Draft Post" --status="draft"` • Categorized post:
|
|
9
|
+
`wp_create_post --title="Tech News" --categories=[1,5] --tags=[10,20]` • Post with featured image:
|
|
10
|
+
`wp_create_post --title="My Post" --content="<p>Content</p>" --featured_media=42` • Remove featured image:
|
|
11
|
+
`wp_create_post --title="My Post" --featured_media=0` • Scheduled post:
|
|
12
|
+
`wp_create_post --title="Future Post" --status="future" --date="2024-12-25T10:00:00"` • Complete post:
|
|
13
|
+
`wp_create_post --title="Complete Post" --content="<p>Content</p>" --excerpt="Summary" --status="publish"`
|
|
15
14
|
|
|
16
15
|
## Parameters
|
|
17
16
|
|
|
18
|
-
| Parameter
|
|
19
|
-
|
|
20
|
-
| `title`
|
|
21
|
-
| `content`
|
|
22
|
-
| `status`
|
|
23
|
-
| `excerpt`
|
|
24
|
-
| `categories`
|
|
25
|
-
| `tags`
|
|
26
|
-
| `featured_media` | `number` | ❌
|
|
17
|
+
| Parameter | Type | Required | Description | Default | Examples |
|
|
18
|
+
| ---------------- | -------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----------------------------------------------------- |
|
|
19
|
+
| `title` | `string` | ✅ | The title for the post. | - | `My Blog Post`, `Hello World` |
|
|
20
|
+
| `content` | `string` | ❌ | The content for the post, in HTML format. | - | `<p>Post content here</p>`, `This is my post content` |
|
|
21
|
+
| `status` | `string` | ❌ | The publishing status for the post. | `publish` | `example` |
|
|
22
|
+
| `excerpt` | `string` | ❌ | The excerpt for the post. | - | `example` |
|
|
23
|
+
| `categories` | `array` | ❌ | An array of category IDs to assign to the post. | - | `example` |
|
|
24
|
+
| `tags` | `array` | ❌ | An array of tag IDs to assign to the post. | - | `example` |
|
|
25
|
+
| `featured_media` | `number` | ❌ | The ID of the featured media (image) for the post. Use wp_upload_media first to get a media ID. Set to 0 or null to remove the featured image. | - | `example` |
|
|
27
26
|
|
|
28
27
|
## Examples
|
|
29
28
|
|
|
@@ -86,8 +85,8 @@ wp_create_post --title="Example Post Title" --content="This is example content f
|
|
|
86
85
|
|
|
87
86
|
**Endpoint:** `/wp-json/wp/v2/posts`
|
|
88
87
|
|
|
89
|
-
This tool directly interfaces with the WordPress REST API endpoint above. The response format and available
|
|
90
|
-
|
|
88
|
+
This tool directly interfaces with the WordPress REST API endpoint above. The response format and available parameters
|
|
89
|
+
are determined by WordPress core functionality.
|
|
91
90
|
|
|
92
91
|
### WordPress Documentation
|
|
93
92
|
|
|
@@ -125,28 +124,24 @@ This tool requires the following WordPress user capabilities:
|
|
|
125
124
|
|
|
126
125
|
### AUTHENTICATION_FAILED
|
|
127
126
|
|
|
128
|
-
**Message:** Authentication failed
|
|
129
|
-
|
|
130
|
-
**Resolution:** Check your authentication credentials and user permissions
|
|
127
|
+
**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
|
|
128
|
+
Check your authentication credentials and user permissions
|
|
131
129
|
|
|
132
130
|
### VALIDATION_ERROR
|
|
133
131
|
|
|
134
|
-
**Message:** Parameter validation failed
|
|
135
|
-
**Description:** One or more required parameters are missing or invalid
|
|
132
|
+
**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
|
|
136
133
|
**Resolution:** Review the required parameters and their formats
|
|
137
134
|
|
|
138
135
|
### NOT_FOUND
|
|
139
136
|
|
|
140
|
-
**Message:** Resource not found
|
|
141
|
-
|
|
142
|
-
**Resolution:** Verify the resource ID and ensure it exists
|
|
137
|
+
**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
|
|
138
|
+
resource ID and ensure it exists
|
|
143
139
|
|
|
144
140
|
### PERMISSION_DENIED
|
|
145
141
|
|
|
146
|
-
**Message:** Insufficient permissions
|
|
147
|
-
**Description:** The user does not have permission to perform this action
|
|
142
|
+
**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
|
|
148
143
|
**Resolution:** Contact an administrator to grant the necessary permissions
|
|
149
144
|
|
|
150
145
|
---
|
|
151
146
|
|
|
152
|
-
|
|
147
|
+
_Generated automatically from tool definitions - Do not edit manually_
|
|
@@ -6,9 +6,9 @@ Creates a new tag.
|
|
|
6
6
|
|
|
7
7
|
## Parameters
|
|
8
8
|
|
|
9
|
-
| Parameter | Type
|
|
10
|
-
|
|
11
|
-
| `name`
|
|
9
|
+
| Parameter | Type | Required | Description | Default | Examples |
|
|
10
|
+
| --------- | -------- | -------- | -------------------- | ------- | --------- |
|
|
11
|
+
| `name` | `string` | ✅ | The name of the tag. | - | `example` |
|
|
12
12
|
|
|
13
13
|
## Examples
|
|
14
14
|
|
|
@@ -17,11 +17,13 @@ Creates a new tag.
|
|
|
17
17
|
Simple example of using wp_create_tag
|
|
18
18
|
|
|
19
19
|
**Command:**
|
|
20
|
+
|
|
20
21
|
```bash
|
|
21
22
|
wp_create_tag --name="example_value"
|
|
22
23
|
```
|
|
23
24
|
|
|
24
25
|
**Response:**
|
|
26
|
+
|
|
25
27
|
```json
|
|
26
28
|
{
|
|
27
29
|
"success": true,
|
|
@@ -34,6 +36,7 @@ wp_create_tag --name="example_value"
|
|
|
34
36
|
```
|
|
35
37
|
|
|
36
38
|
**Error Example (Authentication failure):**
|
|
39
|
+
|
|
37
40
|
```json
|
|
38
41
|
{
|
|
39
42
|
"error": "Authentication failed",
|
|
@@ -41,11 +44,6 @@ wp_create_tag --name="example_value"
|
|
|
41
44
|
}
|
|
42
45
|
```
|
|
43
46
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
47
|
## Response Format
|
|
50
48
|
|
|
51
49
|
**Return Type:** `taxonomy`
|
|
@@ -68,34 +66,24 @@ wp_create_tag --name="example_value"
|
|
|
68
66
|
|
|
69
67
|
### AUTHENTICATION_FAILED
|
|
70
68
|
|
|
71
|
-
**Message:** Authentication failed
|
|
72
|
-
|
|
73
|
-
**Resolution:** Check your authentication credentials and user permissions
|
|
74
|
-
|
|
69
|
+
**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
|
|
70
|
+
Check your authentication credentials and user permissions
|
|
75
71
|
|
|
76
72
|
### VALIDATION_ERROR
|
|
77
73
|
|
|
78
|
-
**Message:** Parameter validation failed
|
|
79
|
-
**Description:** One or more required parameters are missing or invalid
|
|
74
|
+
**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
|
|
80
75
|
**Resolution:** Review the required parameters and their formats
|
|
81
76
|
|
|
82
|
-
|
|
83
77
|
### NOT_FOUND
|
|
84
78
|
|
|
85
|
-
**Message:** Resource not found
|
|
86
|
-
|
|
87
|
-
**Resolution:** Verify the resource ID and ensure it exists
|
|
88
|
-
|
|
79
|
+
**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
|
|
80
|
+
resource ID and ensure it exists
|
|
89
81
|
|
|
90
82
|
### PERMISSION_DENIED
|
|
91
83
|
|
|
92
|
-
**Message:** Insufficient permissions
|
|
93
|
-
**Description:** The user does not have permission to perform this action
|
|
84
|
+
**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
|
|
94
85
|
**Resolution:** Contact an administrator to grant the necessary permissions
|
|
95
86
|
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
87
|
---
|
|
100
88
|
|
|
101
|
-
|
|
89
|
+
_Generated automatically from tool definitions - Do not edit manually_
|
|
@@ -6,12 +6,12 @@ Creates a new user.
|
|
|
6
6
|
|
|
7
7
|
## Parameters
|
|
8
8
|
|
|
9
|
-
| Parameter
|
|
10
|
-
|
|
11
|
-
| `username` | `string` | ✅
|
|
12
|
-
| `email`
|
|
13
|
-
| `password` | `string` | ✅
|
|
14
|
-
| `roles`
|
|
9
|
+
| Parameter | Type | Required | Description | Default | Examples |
|
|
10
|
+
| ---------- | -------- | -------- | ---------------------------------------- | ------- | ------------------------------------ |
|
|
11
|
+
| `username` | `string` | ✅ | The username for the new user. | - | `john_doe`, `admin` |
|
|
12
|
+
| `email` | `string` | ✅ | The email address for the new user. | - | `user@example.com`, `admin@site.com` |
|
|
13
|
+
| `password` | `string` | ✅ | The password for the new user. | - | `example` |
|
|
14
|
+
| `roles` | `array` | ❌ | An array of roles to assign to the user. | - | `example` |
|
|
15
15
|
|
|
16
16
|
## Examples
|
|
17
17
|
|
|
@@ -20,11 +20,13 @@ Creates a new user.
|
|
|
20
20
|
Simple example of using wp_create_user
|
|
21
21
|
|
|
22
22
|
**Command:**
|
|
23
|
+
|
|
23
24
|
```bash
|
|
24
25
|
wp_create_user --username="john_doe" --email="user@example.com"
|
|
25
26
|
```
|
|
26
27
|
|
|
27
28
|
**Response:**
|
|
29
|
+
|
|
28
30
|
```json
|
|
29
31
|
{
|
|
30
32
|
"success": true,
|
|
@@ -37,6 +39,7 @@ wp_create_user --username="john_doe" --email="user@example.com"
|
|
|
37
39
|
```
|
|
38
40
|
|
|
39
41
|
**Error Example (Authentication failure):**
|
|
42
|
+
|
|
40
43
|
```json
|
|
41
44
|
{
|
|
42
45
|
"error": "Authentication failed",
|
|
@@ -44,17 +47,18 @@ wp_create_user --username="john_doe" --email="user@example.com"
|
|
|
44
47
|
}
|
|
45
48
|
```
|
|
46
49
|
|
|
47
|
-
|
|
48
50
|
### Advanced user Configuration
|
|
49
51
|
|
|
50
52
|
Comprehensive example using all available parameters
|
|
51
53
|
|
|
52
54
|
**Command:**
|
|
55
|
+
|
|
53
56
|
```bash
|
|
54
57
|
wp_create_user --username="john_doe" --email="user@example.com" --password="example_value" --roles="example_value"
|
|
55
58
|
```
|
|
56
59
|
|
|
57
60
|
**Response:**
|
|
61
|
+
|
|
58
62
|
```json
|
|
59
63
|
{
|
|
60
64
|
"success": true,
|
|
@@ -66,11 +70,6 @@ wp_create_user --username="john_doe" --email="user@example.com" --password="exam
|
|
|
66
70
|
}
|
|
67
71
|
```
|
|
68
72
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
73
|
## Required Permissions
|
|
75
74
|
|
|
76
75
|
This tool requires the following WordPress user capabilities:
|
|
@@ -79,7 +78,6 @@ This tool requires the following WordPress user capabilities:
|
|
|
79
78
|
|
|
80
79
|
**Note:** The authenticated user must have these capabilities to successfully execute this tool.
|
|
81
80
|
|
|
82
|
-
|
|
83
81
|
## Response Format
|
|
84
82
|
|
|
85
83
|
**Return Type:** `user`
|
|
@@ -102,34 +100,24 @@ This tool requires the following WordPress user capabilities:
|
|
|
102
100
|
|
|
103
101
|
### AUTHENTICATION_FAILED
|
|
104
102
|
|
|
105
|
-
**Message:** Authentication failed
|
|
106
|
-
|
|
107
|
-
**Resolution:** Check your authentication credentials and user permissions
|
|
108
|
-
|
|
103
|
+
**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
|
|
104
|
+
Check your authentication credentials and user permissions
|
|
109
105
|
|
|
110
106
|
### VALIDATION_ERROR
|
|
111
107
|
|
|
112
|
-
**Message:** Parameter validation failed
|
|
113
|
-
**Description:** One or more required parameters are missing or invalid
|
|
108
|
+
**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
|
|
114
109
|
**Resolution:** Review the required parameters and their formats
|
|
115
110
|
|
|
116
|
-
|
|
117
111
|
### NOT_FOUND
|
|
118
112
|
|
|
119
|
-
**Message:** Resource not found
|
|
120
|
-
|
|
121
|
-
**Resolution:** Verify the resource ID and ensure it exists
|
|
122
|
-
|
|
113
|
+
**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
|
|
114
|
+
resource ID and ensure it exists
|
|
123
115
|
|
|
124
116
|
### PERMISSION_DENIED
|
|
125
117
|
|
|
126
|
-
**Message:** Insufficient permissions
|
|
127
|
-
**Description:** The user does not have permission to perform this action
|
|
118
|
+
**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
|
|
128
119
|
**Resolution:** Contact an administrator to grant the necessary permissions
|
|
129
120
|
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
121
|
---
|
|
134
122
|
|
|
135
|
-
|
|
123
|
+
_Generated automatically from tool definitions - Do not edit manually_
|