mcp-wordpress 1.3.0 → 1.4.0

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.
Files changed (95) hide show
  1. package/README.md +149 -789
  2. package/dist/mcp-wordpress-1.4.0.tgz +0 -0
  3. package/docs/DOCKER.md +8 -1
  4. package/docs/api/README.md +82 -75
  5. package/docs/api/categories/auth.md +2 -0
  6. package/docs/api/categories/cache.md +2 -0
  7. package/docs/api/categories/comment.md +2 -0
  8. package/docs/api/categories/media.md +2 -0
  9. package/docs/api/categories/page.md +2 -0
  10. package/docs/api/categories/performance.md +2 -0
  11. package/docs/api/categories/post.md +2 -0
  12. package/docs/api/categories/site.md +2 -0
  13. package/docs/api/categories/taxonomy.md +2 -0
  14. package/docs/api/categories/user.md +2 -0
  15. package/docs/api/tools/wp_approve_comment.md +3 -11
  16. package/docs/api/tools/wp_cache_clear.md +5 -14
  17. package/docs/api/tools/wp_cache_info.md +5 -14
  18. package/docs/api/tools/wp_cache_stats.md +5 -14
  19. package/docs/api/tools/wp_cache_warm.md +5 -14
  20. package/docs/api/tools/wp_create_application_password.md +3 -11
  21. package/docs/api/tools/wp_create_category.md +3 -11
  22. package/docs/api/tools/wp_create_comment.md +5 -14
  23. package/docs/api/tools/wp_create_page.md +5 -13
  24. package/docs/api/tools/wp_create_post.md +6 -12
  25. package/docs/api/tools/wp_create_tag.md +3 -11
  26. package/docs/api/tools/wp_create_user.md +5 -13
  27. package/docs/api/tools/wp_delete_application_password.md +3 -11
  28. package/docs/api/tools/wp_delete_category.md +3 -11
  29. package/docs/api/tools/wp_delete_comment.md +3 -11
  30. package/docs/api/tools/wp_delete_media.md +3 -10
  31. package/docs/api/tools/wp_delete_page.md +3 -10
  32. package/docs/api/tools/wp_delete_post.md +4 -9
  33. package/docs/api/tools/wp_delete_tag.md +3 -11
  34. package/docs/api/tools/wp_delete_user.md +3 -10
  35. package/docs/api/tools/wp_get_application_passwords.md +3 -11
  36. package/docs/api/tools/wp_get_auth_status.md +3 -11
  37. package/docs/api/tools/wp_get_category.md +3 -11
  38. package/docs/api/tools/wp_get_comment.md +3 -11
  39. package/docs/api/tools/wp_get_current_user.md +3 -11
  40. package/docs/api/tools/wp_get_media.md +3 -11
  41. package/docs/api/tools/wp_get_page.md +3 -11
  42. package/docs/api/tools/wp_get_page_revisions.md +3 -11
  43. package/docs/api/tools/wp_get_post.md +4 -10
  44. package/docs/api/tools/wp_get_post_revisions.md +3 -11
  45. package/docs/api/tools/wp_get_site_settings.md +3 -10
  46. package/docs/api/tools/wp_get_tag.md +3 -11
  47. package/docs/api/tools/wp_get_user.md +3 -11
  48. package/docs/api/tools/wp_list_categories.md +3 -11
  49. package/docs/api/tools/wp_list_comments.md +3 -11
  50. package/docs/api/tools/wp_list_media.md +5 -14
  51. package/docs/api/tools/wp_list_pages.md +5 -14
  52. package/docs/api/tools/wp_list_posts.md +6 -13
  53. package/docs/api/tools/wp_list_tags.md +3 -11
  54. package/docs/api/tools/wp_list_users.md +3 -11
  55. package/docs/api/tools/wp_performance_alerts.md +7 -17
  56. package/docs/api/tools/wp_performance_benchmark.md +7 -17
  57. package/docs/api/tools/wp_performance_export.md +7 -17
  58. package/docs/api/tools/wp_performance_history.md +7 -17
  59. package/docs/api/tools/wp_performance_optimize.md +7 -17
  60. package/docs/api/tools/wp_performance_stats.md +7 -17
  61. package/docs/api/tools/wp_search_site.md +3 -11
  62. package/docs/api/tools/wp_spam_comment.md +3 -11
  63. package/docs/api/tools/wp_switch_auth_method.md +5 -14
  64. package/docs/api/tools/wp_test_auth.md +3 -11
  65. package/docs/api/tools/wp_update_category.md +3 -11
  66. package/docs/api/tools/wp_update_comment.md +5 -14
  67. package/docs/api/tools/wp_update_media.md +5 -14
  68. package/docs/api/tools/wp_update_page.md +5 -13
  69. package/docs/api/tools/wp_update_post.md +6 -12
  70. package/docs/api/tools/wp_update_site_settings.md +5 -14
  71. package/docs/api/tools/wp_update_tag.md +3 -11
  72. package/docs/api/tools/wp_update_user.md +5 -13
  73. package/docs/api/tools/wp_upload_media.md +5 -13
  74. package/docs/api/types/WordPressPost.md +0 -2
  75. package/docs/developer/API_REFERENCE.md +628 -0
  76. package/docs/developer/ARCHITECTURE.md +374 -0
  77. package/docs/developer/BUILD_SYSTEM.md +465 -0
  78. package/docs/developer/CONTRIBUTING.md +463 -0
  79. package/docs/developer/DEVELOPMENT_SETUP.md +463 -0
  80. package/docs/developer/GITHUB_ACTIONS_SETUP.md +2 -1
  81. package/docs/developer/MAINTENANCE.md +5 -5
  82. package/docs/developer/MIGRATION_GUIDE.md +7 -5
  83. package/docs/developer/NPM_AUTH_SETUP.md +4 -4
  84. package/docs/developer/README.md +219 -0
  85. package/docs/developer/REFACTORING.md +15 -10
  86. package/docs/developer/RELEASE_PROCESS.md +523 -0
  87. package/docs/developer/TESTING.md +730 -0
  88. package/docs/releases/COMMUNITY_ANNOUNCEMENT_v1.1.2.md +9 -3
  89. package/docs/releases/RELEASE_NOTES_v1.1.2.md +4 -4
  90. package/docs/user-guides/DOCKER_NPM_DTX_SETUP.md +217 -0
  91. package/docs/user-guides/DOCKER_SETUP.md +3 -3
  92. package/docs/user-guides/DTX_SETUP.md +5 -5
  93. package/docs/user-guides/NPX_SETUP.md +2 -2
  94. package/package.json +2 -2
  95. package/dist/mcp-wordpress-1.3.0.tgz +0 -0
@@ -19,11 +19,13 @@ Updates one or more general settings for a WordPress site.
19
19
  Simple example of using wp_update_site_settings
20
20
 
21
21
  **Command:**
22
+
22
23
  ```bash
23
24
  wp_update_site_settings
24
25
  ```
25
26
 
26
27
  **Response:**
28
+
27
29
  ```json
28
30
  {
29
31
  "success": true,
@@ -36,6 +38,7 @@ wp_update_site_settings
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_update_site_settings
43
46
  }
44
47
  ```
45
48
 
46
-
47
49
  ### Advanced site Configuration
48
50
 
49
51
  Comprehensive example using all available parameters
50
52
 
51
53
  **Command:**
54
+
52
55
  ```bash
53
56
  wp_update_site_settings --title="Example Post Title" --description="example_value" --timezone="example_value"
54
57
  ```
55
58
 
56
59
  **Response:**
60
+
57
61
  ```json
58
62
  {
59
63
  "success": true,
@@ -65,13 +69,6 @@ wp_update_site_settings --title="Example Post Title" --description="example_valu
65
69
  }
66
70
  ```
67
71
 
68
-
69
-
70
-
71
-
72
-
73
-
74
-
75
72
  ## Response Format
76
73
 
77
74
  **Return Type:** `site`
@@ -98,30 +95,24 @@ wp_update_site_settings --title="Example Post Title" --description="example_valu
98
95
  **Description:** Invalid credentials or insufficient permissions
99
96
  **Resolution:** Check your authentication credentials and user permissions
100
97
 
101
-
102
98
  ### VALIDATION_ERROR
103
99
 
104
100
  **Message:** Parameter validation failed
105
101
  **Description:** One or more required parameters are missing or invalid
106
102
  **Resolution:** Review the required parameters and their formats
107
103
 
108
-
109
104
  ### NOT_FOUND
110
105
 
111
106
  **Message:** Resource not found
112
107
  **Description:** The requested resource does not exist
113
108
  **Resolution:** Verify the resource ID and ensure it exists
114
109
 
115
-
116
110
  ### PERMISSION_DENIED
117
111
 
118
112
  **Message:** Insufficient permissions
119
113
  **Description:** The user does not have permission to perform this action
120
114
  **Resolution:** Contact an administrator to grant the necessary permissions
121
115
 
122
-
123
-
124
-
125
116
  ---
126
117
 
127
118
  *Generated automatically from tool definitions - Do not edit manually*
@@ -18,11 +18,13 @@ Updates an existing tag.
18
18
  Simple example of using wp_update_tag
19
19
 
20
20
  **Command:**
21
+
21
22
  ```bash
22
23
  wp_update_tag --id="123"
23
24
  ```
24
25
 
25
26
  **Response:**
27
+
26
28
  ```json
27
29
  {
28
30
  "success": true,
@@ -35,6 +37,7 @@ wp_update_tag --id="123"
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_update_tag --id="123"
42
45
  }
43
46
  ```
44
47
 
45
-
46
-
47
-
48
-
49
-
50
48
  ## Response Format
51
49
 
52
50
  **Return Type:** `taxonomy`
@@ -73,30 +71,24 @@ wp_update_tag --id="123"
73
71
  **Description:** Invalid credentials or insufficient permissions
74
72
  **Resolution:** Check your authentication credentials and user permissions
75
73
 
76
-
77
74
  ### VALIDATION_ERROR
78
75
 
79
76
  **Message:** Parameter validation failed
80
77
  **Description:** One or more required parameters are missing or invalid
81
78
  **Resolution:** Review the required parameters and their formats
82
79
 
83
-
84
80
  ### NOT_FOUND
85
81
 
86
82
  **Message:** Resource not found
87
83
  **Description:** The requested resource does not exist
88
84
  **Resolution:** Verify the resource ID and ensure it exists
89
85
 
90
-
91
86
  ### PERMISSION_DENIED
92
87
 
93
88
  **Message:** Insufficient permissions
94
89
  **Description:** The user does not have permission to perform this action
95
90
  **Resolution:** Contact an administrator to grant the necessary permissions
96
91
 
97
-
98
-
99
-
100
92
  ---
101
93
 
102
94
  *Generated automatically from tool definitions - Do not edit manually*
@@ -19,11 +19,13 @@ Updates an existing user.
19
19
  Simple example of using wp_update_user
20
20
 
21
21
  **Command:**
22
+
22
23
  ```bash
23
24
  wp_update_user --id="123"
24
25
  ```
25
26
 
26
27
  **Response:**
28
+
27
29
  ```json
28
30
  {
29
31
  "success": true,
@@ -36,6 +38,7 @@ wp_update_user --id="123"
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_update_user --id="123"
43
46
  }
44
47
  ```
45
48
 
46
-
47
49
  ### Advanced user Configuration
48
50
 
49
51
  Comprehensive example using all available parameters
50
52
 
51
53
  **Command:**
54
+
52
55
  ```bash
53
56
  wp_update_user --id="123" --email="user@example.com" --name="example_value"
54
57
  ```
55
58
 
56
59
  **Response:**
60
+
57
61
  ```json
58
62
  {
59
63
  "success": true,
@@ -65,11 +69,6 @@ wp_update_user --id="123" --email="user@example.com" --name="example_value"
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:
@@ -78,7 +77,6 @@ This tool requires the following WordPress user capabilities:
78
77
 
79
78
  **Note:** The authenticated user must have these capabilities to successfully execute this tool.
80
79
 
81
-
82
80
  ## Response Format
83
81
 
84
82
  **Return Type:** `user`
@@ -105,30 +103,24 @@ This tool requires the following WordPress user capabilities:
105
103
  **Description:** Invalid credentials or insufficient permissions
106
104
  **Resolution:** Check your authentication credentials and user permissions
107
105
 
108
-
109
106
  ### VALIDATION_ERROR
110
107
 
111
108
  **Message:** Parameter validation failed
112
109
  **Description:** One or more required parameters are missing or invalid
113
110
  **Resolution:** Review the required parameters and their formats
114
111
 
115
-
116
112
  ### NOT_FOUND
117
113
 
118
114
  **Message:** Resource not found
119
115
  **Description:** The requested resource does not exist
120
116
  **Resolution:** Verify the resource ID and ensure it exists
121
117
 
122
-
123
118
  ### PERMISSION_DENIED
124
119
 
125
120
  **Message:** Insufficient permissions
126
121
  **Description:** The user does not have permission to perform this action
127
122
  **Resolution:** Contact an administrator to grant the necessary permissions
128
123
 
129
-
130
-
131
-
132
124
  ---
133
125
 
134
126
  *Generated automatically from tool definitions - Do not edit manually*
@@ -22,11 +22,13 @@ Uploads a file to the WordPress media library.
22
22
  Simple example of using wp_upload_media
23
23
 
24
24
  **Command:**
25
+
25
26
  ```bash
26
27
  wp_upload_media --file_path="example_value"
27
28
  ```
28
29
 
29
30
  **Response:**
31
+
30
32
  ```json
31
33
  {
32
34
  "success": true,
@@ -36,6 +38,7 @@ wp_upload_media --file_path="example_value"
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_upload_media --file_path="example_value"
43
46
  }
44
47
  ```
45
48
 
46
-
47
49
  ### Advanced media Configuration
48
50
 
49
51
  Comprehensive example using all available parameters
50
52
 
51
53
  **Command:**
54
+
52
55
  ```bash
53
56
  wp_upload_media --file_path="example_value" --title="Example Post Title" --alt_text="example_value" --caption="example_value" --description="example_value" --post="example_value"
54
57
  ```
55
58
 
56
59
  **Response:**
60
+
57
61
  ```json
58
62
  {
59
63
  "success": true,
@@ -62,11 +66,6 @@ wp_upload_media --file_path="example_value" --title="Example Post Title" --alt_t
62
66
  }
63
67
  ```
64
68
 
65
-
66
-
67
-
68
-
69
-
70
69
  ## Required Permissions
71
70
 
72
71
  This tool requires the following WordPress user capabilities:
@@ -75,7 +74,6 @@ This tool requires the following WordPress user capabilities:
75
74
 
76
75
  **Note:** The authenticated user must have these capabilities to successfully execute this tool.
77
76
 
78
-
79
77
  ## Response Format
80
78
 
81
79
  **Return Type:** `object`
@@ -102,30 +100,24 @@ This tool requires the following WordPress user capabilities:
102
100
  **Description:** Invalid credentials or insufficient permissions
103
101
  **Resolution:** Check your authentication credentials and user permissions
104
102
 
105
-
106
103
  ### VALIDATION_ERROR
107
104
 
108
105
  **Message:** Parameter validation failed
109
106
  **Description:** One or more required parameters are missing or invalid
110
107
  **Resolution:** Review the required parameters and their formats
111
108
 
112
-
113
109
  ### NOT_FOUND
114
110
 
115
111
  **Message:** Resource not found
116
112
  **Description:** The requested resource does not exist
117
113
  **Resolution:** Verify the resource ID and ensure it exists
118
114
 
119
-
120
115
  ### PERMISSION_DENIED
121
116
 
122
117
  **Message:** Insufficient permissions
123
118
  **Description:** The user does not have permission to perform this action
124
119
  **Resolution:** Contact an administrator to grant the necessary permissions
125
120
 
126
-
127
-
128
-
129
121
  ---
130
122
 
131
123
  *Generated automatically from tool definitions - Do not edit manually*
@@ -35,5 +35,3 @@ WordPress blog post object
35
35
  "slug": "welcome-to-wordpress"
36
36
  }
37
37
  ```
38
-
39
-