@wisewandtools/mcp-server 2.0.15 → 2.0.17

package/README.md

@@ -630,6 +630,27 @@ src/
 - ✅ Docker security best practices
 - ✅ Non-root container execution
 
+## Known Limitations
+
+### API Response Limitations
+
+#### Minimal GET Responses
+The `get_article`, `get_category_page`, and `get_product_page` functions return minimal data (typically just ID and status) due to the Wisewand API design. To retrieve full content including the generated HTML/markdown:
+
+- **For articles**: Use `get_article_output` instead of `get_article`
+- **For category pages**: Use `get_category_page_output` instead of `get_category_page`
+- **For product pages**: Use `get_product_page_output` instead of `get_product_page`
+
+#### RSS Feed Integration
+The RSS feed creation feature (`create_rss_feed`) currently has upstream integration issues with RSS.app. This is a known limitation of the Wisewand API backend. The MCP server correctly forwards requests, but you may encounter 400 Bad Request errors from the RSS.app service.
+
+**Workaround**: Use direct RSS feed URLs or alternative RSS feed generation services until this is resolved.
+
+#### Category/Product Cost Estimation
+The `estimate_category_page_cost` and `estimate_product_page_cost` endpoints may return validation errors as these features are not yet fully available in the Wisewand API.
+
+**Workaround**: Use `estimate_article_cost` as a proxy to estimate costs for similar content, as the underlying generation mechanisms are similar.
+
 ## Troubleshooting
 
 ### Claude Desktop Integration Issues

package/dist/index.js

@@ -370,10 +370,10 @@ var WisewandAPIClient = class {
     return this.request("POST", "/v1/articles/cost", input);
   }
   async createBulkArticles(articles) {
-    return this.request("POST", "/v1/articles/bulk", { articles });
+    return this.request("POST", "/v1/articles/bulk", articles);
   }
   async calculateBulkCost(articles) {
-    return this.request("POST", "/v1/articles/bulk/cost", { articles });
+    return this.request("POST", "/v1/articles/bulk/cost", articles);
   }
   // ============= Project Operations =============
   async createProject(input) {
@@ -1764,7 +1764,7 @@ var ArticleToolHandler = class {
         try {
           const cost = await this.apiClient.calculateArticleCost(args);
           this.metrics.recordAPICall("estimate_cost", "success");
-          return { content: [{ type: "text", text: JSON.stringify({ success: true, cost_estimate: cost, message: `Estimated cost: ${cost.credits} credits ($${cost.cost_usd})` }, null, 2) }] };
+          return { content: [{ type: "text", text: JSON.stringify({ success: true, cost_estimate: cost, message: `Estimated cost: ${cost.credits} credits ($${cost.cost})` }, null, 2) }] };
         } catch (error) {
           logger.error("Failed to estimate cost", { error: error.message });
           this.metrics.recordAPICall("estimate_cost", "error");
@@ -3428,7 +3428,7 @@ var CreateCategoryPageSchema = z6.object({
   title: z6.string().optional(),
   category: z6.string().optional(),
   // Standard fields
-  lang: z6.enum(LANG_ENUM2).optional().default("en"),
+  lang: z6.enum(LANG_ENUM2).optional(),
   country: z6.enum(COUNTRY_ENUM2).optional(),
   project_id: z6.string().uuid().optional(),
   persona_id: z6.string().uuid().optional(),
@@ -3483,7 +3483,7 @@ var CategoryPagesToolHandler = class {
           subject: { type: "string", description: "Category subject/topic", minLength: 1 },
           title: { type: "string", description: "Category page title" },
           category: { type: "string", description: "Category name/slug" },
-          lang: { type: "string", enum: [...LANG_ENUM2], description: "Language for the category page", default: "en" },
+          lang: { type: "string", enum: [...LANG_ENUM2], description: "Language for the category page" },
           country: { type: "string", enum: [...COUNTRY_ENUM2], description: "Target country for localization" },
           project_id: { type: "string", format: "uuid", description: "Project UUID" },
           persona_id: { type: "string", format: "uuid", description: "Persona UUID" },
@@ -3512,7 +3512,7 @@ var CategoryPagesToolHandler = class {
           await this.cache.set(`category_page:${categoryPage.id}`, categoryPage, 300);
           this.metrics.recordAPICall("create_category_page", "success");
           return {
-            content: [{ type: "text", text: JSON.stringify({ success: true, category_page_id: categoryPage.id, name: categoryPage.name, message: `Category page "${categoryPage.name}" created successfully`, next_steps: [`Use 'generate_category_page' with id: ${categoryPage.id}`, `Use 'get_category_page' with id: ${categoryPage.id}`] }, null, 2) }]
+            content: [{ type: "text", text: JSON.stringify({ success: true, category_page_id: categoryPage.id, name: categoryPage.name || validated.name, message: `Category page "${categoryPage.name || validated.name}" created successfully`, next_steps: [`Use 'generate_category_page' with id: ${categoryPage.id}`, `Use 'get_category_page' with id: ${categoryPage.id}`] }, null, 2) }]
           };
         } catch (error) {
           logger.error("Failed to create category page", { error: error.message });
@@ -3729,7 +3729,7 @@ var CreateProductPageSchema = z7.object({
   product_url: z7.string().url().optional(),
   product_description: z7.string().optional(),
   // Standard fields
-  lang: z7.enum(LANG_ENUM3).optional().default("en"),
+  lang: z7.enum(LANG_ENUM3).optional(),
   country: z7.enum(COUNTRY_ENUM3).optional(),
   project_id: z7.string().uuid().optional(),
   persona_id: z7.string().uuid().optional(),
@@ -3786,7 +3786,7 @@ var ProductPagesToolHandler = class {
           product_name: { type: "string", description: "Name of the product" },
           product_url: { type: "string", format: "uri", description: "URL of the product" },
           product_description: { type: "string", description: "Product description" },
-          lang: { type: "string", enum: [...LANG_ENUM3], description: "Language for the product page", default: "en" },
+          lang: { type: "string", enum: [...LANG_ENUM3], description: "Language for the product page" },
           country: { type: "string", enum: [...COUNTRY_ENUM3], description: "Target country for localization" },
           project_id: { type: "string", format: "uuid", description: "Project UUID" },
           persona_id: { type: "string", format: "uuid", description: "Persona UUID" },
@@ -3814,7 +3814,7 @@ var ProductPagesToolHandler = class {
           const productPage = await this.apiClient.createProductPage(validated);
           await this.cache.set(`product_page:${productPage.id}`, productPage, 300);
           this.metrics.recordAPICall("create_product_page", "success");
-          return { content: [{ type: "text", text: JSON.stringify({ success: true, product_page_id: productPage.id, name: productPage.name, message: `Product page "${productPage.name}" created successfully`, next_steps: [`Use 'generate_product_page' with id: ${productPage.id}`, `Use 'get_product_page' with id: ${productPage.id}`] }, null, 2) }] };
+          return { content: [{ type: "text", text: JSON.stringify({ success: true, product_page_id: productPage.id, name: productPage.name || validated.name, message: `Product page "${productPage.name || validated.name}" created successfully`, next_steps: [`Use 'generate_product_page' with id: ${productPage.id}`, `Use 'get_product_page' with id: ${productPage.id}`] }, null, 2) }] };
         } catch (error) {
           logger.error("Failed to create product page", { error: error.message });
           this.metrics.recordAPICall("create_product_page", "error");
@@ -5767,25 +5767,6 @@ Here are 5 powerful workflows that Wisewand users love:
 
 ---
 
-### \u{1F504} Workflow 5: Update Old Content
-
-**Goal:** Refresh 50 old articles with new info
-
-\`\`\`
-1. List existing WordPress posts via get_posts
-2. Use update_post to refresh content:
-   - Add new statistics/data
-   - Update outdated sections
-   - Improve SEO based on current trends
-3. Batch process with create_bulk_update
-4. Monitor via get_job_status
-5. Re-publish updated articles
-\`\`\`
-
-**Impact:** Revive organic traffic from existing content
-
----
-
 **Which workflow matches your use case?** Each can be customized further with personas, custom images, and advanced SEO settings.
 
 Want to learn best practices next?`