posterly-mcp-server 0.20.0 → 0.20.1

package/README.md

@@ -108,7 +108,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.20.0` exposes 56 tools.
+`posterly-mcp-server@0.20.1` exposes 56 tools.
 
 Public setup tools work before `POSTERLY_API_KEY` exists:
 

package/dist/lib/api-client.js

@@ -85,7 +85,7 @@ export class PosterlyClient {
         const res = await fetch(url, init);
         if (!res.ok) {
             const err = await res.json().catch(() => ({ error: res.statusText }));
-            throw new Error(err.error || `API error: ${res.status}`);
+            throw new Error(formatApiError(res, err));
         }
         return res.json();
     }
@@ -100,7 +100,7 @@ export class PosterlyClient {
         const res = await fetch(url, init);
         if (!res.ok) {
             const err = await res.json().catch(() => ({ error: res.statusText }));
-            throw new Error(err.error || `API error: ${res.status}`);
+            throw new Error(formatApiError(res, err));
         }
         return res.json();
     }
@@ -470,6 +470,24 @@ function formatProbeError(data, fallback, statusText) {
     }
     return fallback || statusText || 'API request failed';
 }
+function formatApiError(res, data) {
+    const message = data?.error || data?.message || `API error: ${res.status}`;
+    if (res.status !== 429) {
+        return message;
+    }
+    const retryAfter = data?.retry_after || res.headers.get('retry-after');
+    const requestId = data?.request_id || res.headers.get('x-request-id');
+    const limit = data?.limit || res.headers.get('x-ratelimit-limit');
+    const reset = data?.reset || res.headers.get('x-ratelimit-reset');
+    return [
+        'Rate limit reached.',
+        retryAfter ? `Try again in ${retryAfter} seconds.` : '',
+        limit ? `Limit: ${limit}.` : '',
+        reset ? `Reset: ${reset}.` : '',
+        requestId ? `Request ID: ${requestId}.` : '',
+        message && message !== 'Rate limit exceeded' ? `Details: ${message}` : '',
+    ].filter(Boolean).join(' ');
+}
 function guessContentType(filename) {
     const ext = filename.split('.').pop()?.toLowerCase();
     const map = {

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.20.0";
+export declare const POSTERLY_MCP_VERSION = "0.20.1";

package/dist/lib/version.js

@@ -1 +1 @@
-export const POSTERLY_MCP_VERSION = '0.20.0';
+export const POSTERLY_MCP_VERSION = '0.20.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.20.0",
+  "version": "0.20.1",
   "description": "MCP server for posterly — schedule social media posts from Claude Desktop",
   "license": "MIT",
   "homepage": "https://www.poster.ly/mcp",

package/src/lib/api-client.ts

@@ -611,7 +611,7 @@ export class PosterlyClient {
 
     if (!res.ok) {
       const err = await res.json().catch(() => ({ error: res.statusText }));
-      throw new Error(err.error || `API error: ${res.status}`);
+      throw new Error(formatApiError(res, err));
     }
 
     return res.json() as Promise<T>;
@@ -635,7 +635,7 @@ export class PosterlyClient {
 
     if (!res.ok) {
       const err = await res.json().catch(() => ({ error: res.statusText }));
-      throw new Error(err.error || `API error: ${res.status}`);
+      throw new Error(formatApiError(res, err));
     }
 
     return res.json() as Promise<T>;
@@ -1222,6 +1222,27 @@ function formatProbeError(data: any, fallback: string, statusText: string): stri
   return fallback || statusText || 'API request failed';
 }
 
+function formatApiError(res: Response, data: any): string {
+  const message = data?.error || data?.message || `API error: ${res.status}`;
+  if (res.status !== 429) {
+    return message;
+  }
+
+  const retryAfter = data?.retry_after || res.headers.get('retry-after');
+  const requestId = data?.request_id || res.headers.get('x-request-id');
+  const limit = data?.limit || res.headers.get('x-ratelimit-limit');
+  const reset = data?.reset || res.headers.get('x-ratelimit-reset');
+
+  return [
+    'Rate limit reached.',
+    retryAfter ? `Try again in ${retryAfter} seconds.` : '',
+    limit ? `Limit: ${limit}.` : '',
+    reset ? `Reset: ${reset}.` : '',
+    requestId ? `Request ID: ${requestId}.` : '',
+    message && message !== 'Rate limit exceeded' ? `Details: ${message}` : '',
+  ].filter(Boolean).join(' ');
+}
+
 function guessContentType(filename: string): string {
   const ext = filename.split('.').pop()?.toLowerCase();
   const map: Record<string, string> = {

package/src/lib/version.ts

@@ -1 +1 @@
-export const POSTERLY_MCP_VERSION = '0.20.0';
+export const POSTERLY_MCP_VERSION = '0.20.1';