@shippo/shippo-mcp 0.5.0 → 0.8.0

package/README.md

@@ -8,7 +8,7 @@ Model Context Protocol (MCP) Server for the Shippo API.
 
 
 You must register for a [Shippo account](https://apps.goshippo.com/join) to use our API. It's free to sign up. Only pay to print a live label — test labels are free.  
-To use the MCP server, you’ll need an [API Token](https://docs.goshippo.com/docs/guides_general/authentication/). Replace `<YOUR_SHIPPO_API_KEY>` with your own token in examples.
+To use the MCP server, you'll need an [API Token](https://docs.goshippo.com/docs/guides_general/authentication/). Replace `YOUR_SHIPPO_API_KEY` with your own token (including the `ShippoToken ` prefix) in the examples below.
 
 <!-- Start Summary [summary] -->
 ## Summary
@@ -37,9 +37,9 @@ Shippo MCP Server: Use this MCP Server to integrate with the Shippo service usin
 <details>
 <summary>Cursor</summary>
 
-[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=shippo-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBzaGlwcG8vc2hpcHBvLW1jcCIsInN0YXJ0IiwiLS1hcGkta2V5LWhlYWRlciIsIllPVVJfU0hJUFBPX0FQSV9LRVkiLCItLXNoaXBwby1hcGktdmVyc2lvbiIsIjIwMTgtMDItMDgiXX0=)
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=shippo-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBzaGlwcG8vc2hpcHBvLW1jcCIsInN0YXJ0IiwiLS1hcGkta2V5LWhlYWRlciIsIlNoaXBwb1Rva2VuIFlPVVJfU0hJUFBPX0FQSV9LRVkiLCItLXNoaXBwby1hcGktdmVyc2lvbiIsIjIwMTgtMDItMDgiXX0=)
 
-> **Tip**: When the installation dialog opens in Cursor, remember to replace `YOUR_SHIPPO_API_KEY` with your actual credential before saving.
+> ⚠️ **Important**: Click **Install** first to add the server, then go to **Settings → Tools & MCP → shippo-mcp (edit)** to edit the configuration. Replace `YOUR_SHIPPO_API_KEY` with your actual API key (keep the `ShippoToken ` prefix), then save `mcp.json`, and toggle shippo-mcp on and off for changes to take effect.
 
 Or manually:
 
@@ -57,7 +57,7 @@ Or manually:
         "@shippo/shippo-mcp",
         "start",
         "--api-key-header",
-        "YOUR_SHIPPO_API_KEY",
+        "ShippoToken YOUR_SHIPPO_API_KEY",
         "--shippo-api-version",
         "2018-02-08"
       ]
@@ -72,7 +72,7 @@ Or manually:
 <summary>Claude Code CLI</summary>
 
 ```bash
-claude mcp add @shippo/shippo-mcp npx @shippo-mcp start -- --api-key-header ... --shippo-api-version 2018-02-08
+claude mcp add @shippo/shippo-mcp npx @shippo-mcp start -- --api-key-header "ShippoToken YOUR_SHIPPO_API_KEY" --shippo-api-version 2018-02-08
 ```
 
 </details>
@@ -99,7 +99,7 @@ Paste the following config in the configuration
         "@shippo/shippo-mcp",
         "start",
         "--api-key-header",
-        "...",
+        "ShippoToken YOUR_SHIPPO_API_KEY",
         "--shippo-api-version",
         "2018-02-08"
       ]
@@ -112,16 +112,19 @@ Paste the following config in the configuration
 
 
 <details>
-<summary> Stdio installation via npm </summary>
-To start the MCP server, run:
+<summary> Manual CLI usage </summary>
+
+If you need to start the MCP server manually (e.g., for use with other MCP clients or debugging), run:
 
 ```bash
-npx @shippo/shippo-mcp start --api-key-header ... --shippo-api-version 2018-02-08
+npx @shippo/shippo-mcp start --api-key-header "ShippoToken YOUR_SHIPPO_API_KEY" --shippo-api-version 2018-02-08
 ```
 
+> **Note:** This starts the server in stdio mode, waiting for MCP protocol messages. It won't show an interactive prompt — it's designed to be connected to by an MCP client like Cursor or Claude Desktop.
+
 For a full list of server arguments, run:
 
-```
+```bash
 npx @shippo/shippo-mcp --help
 ```
 
@@ -150,7 +153,7 @@ To run the server locally from source (e.g., for development), use the following
         "/ABSOLUTE/PATH/TO/REPO/bin/mcp-server.js",
         "start",
         "--api-key-header",
-        "YOUR_SHIPPO_API_KEY",
+        "ShippoToken YOUR_SHIPPO_API_KEY",
         "--shippo-api-version",
         "2018-02-08"
       ]
@@ -176,7 +179,7 @@ Replace `/ABSOLUTE/PATH/TO/REPO` with the full path to your cloned repository.
         "@shippo/shippo-mcp",
         "start",
         "--api-key-header",
-        "YOUR_SHIPPO_API_KEY",
+        "ShippoToken YOUR_SHIPPO_API_KEY",
         "--shippo-api-version",
         "2018-02-08"
       ]
@@ -188,7 +191,7 @@ Replace `/ABSOLUTE/PATH/TO/REPO` with the full path to your cloned repository.
 ### Command Line
 
 ```bash
-npx @shippo/shippo-mcp start --api-key-header YOUR_SHIPPO_API_KEY --shippo-api-version 2018-02-08
+npx @shippo/shippo-mcp start --api-key-header "ShippoToken YOUR_SHIPPO_API_KEY" --shippo-api-version 2018-02-08
 ```
 
 <!-- End Configuration [configuration] -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shippo/shippo-mcp",
-  "version": "0.5.0",
+  "version": "0.8.0",
   "author": "shippo",
   "type": "module",
   "sideEffects": false,