@codespar/mcp-coordinadora 0.2.0-alpha.1 → 0.2.0-alpha.2

package/README.md

@@ -1,5 +1,8 @@
 # MCP Coordinadora
 
+
+> **Alpha release** — published under the `alpha` npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during `0.x.x-alpha`. Install with `npm install <pkg>@alpha`.
+
 MCP server for **Coordinadora** — one of Colombia's largest courier and logistics companies, offering domestic and international shipping services.
 
 ## Quick Start
@@ -25,18 +28,29 @@ npx tsx packages/colombia/coordinadora/src/index.ts --http
 | `MCP_HTTP` | No | Set to `"true"` to enable HTTP transport |
 | `MCP_PORT` | No | HTTP port (default: 3000) |
 
-## Tools
+## Tools (19)
 
-| Tool | Description |
-|------|-------------|
+| Tool | Purpose |
+|---|---|
 | `create_shipment` | Create a new shipment |
 | `get_shipment` | Get shipment details by guide number |
-| `track_shipment` | Track a shipment |
+| `track_shipment` | Track a shipment by guide number |
 | `get_rates` | Get shipping rates/quotes |
 | `list_cities` | List available cities for shipping |
-| `create_pickup` | Schedule a pickup |
-| `get_coverage` | Check coverage for a location |
+| `create_pickup` | Schedule a pickup at an address |
+| `get_coverage` | Check if a location is within coverage area |
 | `cancel_shipment` | Cancel a shipment |
+| `get_guia_pdf` | Download a guía label as PDF (returns base64 or URL) |
+| `get_pickup` | Get pickup (recolección) details by id |
+| `cancel_pickup` | Cancel a scheduled pickup (recolección) |
+| `get_tracking_history` | Get full tracking event history for a guía |
+| `list_shipments_by_date` | List guías created within a date range |
+| `validate_coverage` | Validate that a city + postal code combination is covered |
+| `list_services` | List available service types for a given origin/destination |
+| `list_offices` | List Coordinadora branch offices (oficinas) |
+| `create_return` | Create a reverse-logistics return guía |
+| `list_returns` | List existing return guías |
+| `create_bulk_guias` | Create multiple guías in a single batch operation |
 
 ## Auth
 

package/dist/index.js

@@ -53,7 +53,7 @@ async function coordinadoraRequest(method, path, body) {
     }
     return res.json();
 }
-const server = new Server({ name: "mcp-coordinadora", version: "0.2.0-alpha.1" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "mcp-coordinadora", version: "0.2.0-alpha.2" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -530,7 +530,7 @@ async function main() {
                 const t = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID(), onsessioninitialized: (id) => { transports.set(id, t); } });
                 t.onclose = () => { if (t.sessionId)
                     transports.delete(t.sessionId); };
-                const s = new Server({ name: "mcp-coordinadora", version: "0.2.0-alpha.1" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-coordinadora", version: "0.2.0-alpha.2" }, { capabilities: { tools: {} } });
                 server._requestHandlers.forEach((v, k) => s._requestHandlers.set(k, v));
                 server._notificationHandlers?.forEach((v, k) => s._notificationHandlers.set(k, v));
                 await s.connect(t);

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@codespar/mcp-coordinadora",
-  "version": "0.2.0-alpha.1",
-  "description": "MCP server for Coordinadora — Colombian courier and logistics",
+  "version": "0.2.0-alpha.2",
+  "description": "MCP server for Coordinadora \u2014 Colombian courier and logistics",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
     "mcp-coordinadora": "dist/index.js"
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js"
@@ -20,6 +22,13 @@
     "typescript": "^5.8.0"
   },
   "license": "MIT",
-  "keywords": ["coordinadora", "courier", "logistics", "colombia", "shipping", "mcp"],
+  "keywords": [
+    "coordinadora",
+    "courier",
+    "logistics",
+    "colombia",
+    "shipping",
+    "mcp"
+  ],
   "mcpName": "io.github.codespar/mcp-coordinadora"
 }