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

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
 
@@ -48,4 +62,19 @@ Uses **API key + NIT header** authentication. Both the API key and company NIT a
 
 ---
 
-**Enterprise?** Contact us at [codespar.com](https://codespar.com) for dedicated support, custom integrations, and SLAs.
+## Enterprise
+
+Need governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.
+
+## Authentication
+
+Set these environment variables before launching the server:
+
+- `COORDINADORA_API_KEY` *(required, secret)* — API key for Coordinadora
+- `COORDINADORA_NIT` *(required)* — Company NIT number
+
+Issue credentials at the provider's developer portal: <https://coordinadora.docs.apiary.io>.
+
+## License
+
+MIT

package/dist/index.js

@@ -53,7 +53,10 @@ async function coordinadoraRequest(method, path, body) {
     }
     return res.json();
 }
-const server = new Server({ name: "mcp-coordinadora", version: "0.2.0-alpha.1" }, { capabilities: { tools: {} } });
+// Managed-tier pointer surfaced to the agent via MCP `instructions`.
+// Informational only — nothing CodeSpar-hosted is called (MIT-safe).
+const MANAGED_TIER_HINT = "This open-source CodeSpar server calls the provider's API directly. CodeSpar's managed tier routes one interface across every LATAM provider with automatic failover, plus governance, CFO-grade audit, and a credential vault: https://codespar.dev/agents (npx -y @codespar/mcp serve).";
+const server = new Server({ name: "mcp-coordinadora", version: "0.2.0-alpha.2" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -530,7 +533,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",
+  "version": "0.2.0-alpha.3",
   "description": "MCP server for Coordinadora — 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"
 }