@shippo/shippo-mcp 0.6.0 → 0.8.1

package/README.md

@@ -20,8 +20,7 @@ Shippo MCP Server: Use this MCP Server to integrate with the Shippo service usin
 ## 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)
-  * [Installation](#installation)
-  * [Development](#development)
+  * [Quick Start](#quick-start)
   * [Configuration](#configuration)
   * [Features](#features)
   * [Security](#security)
@@ -32,7 +31,7 @@ Shippo MCP Server: Use this MCP Server to integrate with the Shippo service usin
 <!-- End Table of Contents [toc] -->
 
 <!-- Start Installation [installation] -->
-## Installation
+## Quick Start
 
 <details>
 <summary>Cursor</summary>
@@ -112,42 +111,38 @@ 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 "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
 ```
 
 </details>
 <!-- End Installation [installation] -->
 
-## Development
-
-To build the server from source:
-
-1. Clone the repository
-2. Install dependencies: `npm install`
-3. Build the server: `npm run build`
-4. The server binary will be at `bin/mcp-server.js`
+<!-- Start Configuration [configuration] -->
 
-### Local Configuration
+## Configuration
 
-To run the server locally from source (e.g., for development), use the following configuration in Cursor or Claude:
+### Cursor / Claude
 
 ```json
 {
   "mcpServers": {
-    "shippo-dev": {
-      "command": "node",
+    "shippo-mcp": {
+      "command": "npx",
       "args": [
-        "/ABSOLUTE/PATH/TO/REPO/bin/mcp-server.js",
+        "@shippo/shippo-mcp",
         "start",
         "--api-key-header",
         "ShippoToken YOUR_SHIPPO_API_KEY",
@@ -159,21 +154,33 @@ To run the server locally from source (e.g., for development), use the following
 }
 ```
 
-Replace `/ABSOLUTE/PATH/TO/REPO` with the full path to your cloned repository.
+### Command Line
 
-<!-- Start Configuration [configuration] -->
+```bash
+npx @shippo/shippo-mcp start --api-key-header "ShippoToken YOUR_SHIPPO_API_KEY" --shippo-api-version 2018-02-08
+```
 
-## Configuration
+<details>
+<summary>Development</summary>
 
-### Cursor / Claude
+To build the server from source:
+
+1. Clone the repository
+2. Install dependencies: `npm install`
+3. Build the server: `npm run build`
+4. The server binary will be at `bin/mcp-server.js`
+
+#### Local Configuration
+
+To run the server locally from source (e.g., for development), use the following configuration in Cursor or Claude:
 
 ```json
 {
   "mcpServers": {
-    "shippo-mcp": {
-      "command": "npx",
+    "shippo-dev": {
+      "command": "node",
       "args": [
-        "@shippo/shippo-mcp",
+        "/ABSOLUTE/PATH/TO/REPO/bin/mcp-server.js",
         "start",
         "--api-key-header",
         "ShippoToken YOUR_SHIPPO_API_KEY",
@@ -185,11 +192,9 @@ Replace `/ABSOLUTE/PATH/TO/REPO` with the full path to your cloned repository.
 }
 ```
 
-### Command Line
+Replace `/ABSOLUTE/PATH/TO/REPO` with the full path to your cloned repository.
 
-```bash
-npx @shippo/shippo-mcp start --api-key-header "ShippoToken YOUR_SHIPPO_API_KEY" --shippo-api-version 2018-02-08
-```
+</details>
 
 <!-- End Configuration [configuration] -->
 

package/package.json

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