@shippo/shippo-mcp 1.0.0 → 2.0.2

package/README.md

@@ -16,13 +16,19 @@ To use the MCP server, you'll need an [API Token](https://docs.goshippo.com/docs
 Shippo MCP Server: Use this MCP Server to integrate with the Shippo service using natural language and agentic flows.
 <!-- End Summary [summary] -->
 
+## Requirements
+
+- **Node.js 18+**
+
 <!-- Start Table of Contents [toc] -->
 ## Table of Contents
 <!-- $toc-max-depth=2 -->
 * [<img src="https://docs.goshippo.com/images/Logo.png" width="30" alt="Shippo logo"> Shippo MCP Server](#img-srchttpsdocsgoshippocomimageslogopng-width30-altshippo-logo-shippo-mcp-server)
+  * [Requirements](#requirements)
   * [Quick Start](#quick-start)
   * [Configuration](#configuration)
   * [Updating](#updating)
+  * [Troubleshooting](#troubleshooting)
   * [Features](#features)
   * [Security](#security)
   * [Contributions](#contributions)
@@ -221,6 +227,65 @@ Next time you start your MCP client (Cursor, Claude), it will fetch the latest v
 
 <!-- End Updating [updating] -->
 
+## Troubleshooting
+
+### `ReferenceError: Response is not defined`
+
+This error occurs when running with Node.js < 18, or when the npx cache contains a stale installation from an older Node version.
+
+**If you use nvm (Node Version Manager):**
+
+```bash
+# 1. Set Node 18+ as default
+nvm alias default 20
+nvm use 20
+
+# 2. Verify Node version
+node --version   # Should show v20.x.x or v18.x.x
+
+# 3. Clear npm/npx caches (this is the key step)
+npm cache clean --force
+rm -rf ~/.npm/_npx/
+
+# 4. (Optional) Clear nvm's cache too
+nvm cache clear
+
+# 5. Restart terminal to pick up fresh environment
+exec "$SHELL"
+
+# 6. Verify npx will use correct Node
+which npx   # Should point to v20 or v18 path
+```
+
+Then restart your MCP client (Cursor/Claude Desktop).
+
+**Alternative: Global Install**
+
+If cache issues persist, install globally instead of using npx:
+
+```bash
+npm install -g @shippo/shippo-mcp
+```
+
+Then update your MCP configuration to use the global command directly:
+
+```json
+{
+  "mcpServers": {
+    "shippo-mcp": {
+      "command": "shippo-mcp",
+      "args": [
+        "start",
+        "--api-key-header",
+        "ShippoToken YOUR_SHIPPO_API_KEY",
+        "--shippo-api-version",
+        "2018-02-08"
+      ]
+    }
+  }
+}
+```
+
 <!-- Start Features [features] -->
 
 ## Features