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

package/README.md

@@ -1,5 +1,8 @@
 # MCP Andreani
 
+
+> **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 **Andreani** — the largest Argentine courier and logistics company, providing domestic and international shipping services.
 
 ## Quick Start
@@ -27,18 +30,28 @@ npx tsx packages/argentina/andreani/src/index.ts --http
 | `MCP_HTTP` | No | Set to `"true"` to enable HTTP transport |
 | `MCP_PORT` | No | HTTP port (default: 3000) |
 
-## Tools
+## Tools (18)
 
-| Tool | Description |
-|------|-------------|
+| Tool | Purpose |
+|---|---|
 | `create_shipment` | Create a new shipment |
 | `get_shipment` | Get shipment details by ID |
 | `track_shipment` | Track a shipment by tracking number |
 | `get_rates` | Get shipping rates/quotes |
 | `list_branches` | List Andreani branches/sucursales |
-| `create_label` | Generate a shipping label |
-| `get_tracking_history` | Get full tracking history |
+| `create_label` | Generate a shipping label for a shipment |
+| `get_tracking_history` | Get full tracking history for a shipment |
 | `cancel_shipment` | Cancel a shipment |
+| `get_label_pdf` | Download a shipping label as PDF (base64-encoded) |
+| `list_tracking_by_date` | List tracking events for a contract within a date range |
+| `validate_postal_code` | Validate CP coverage and list available services for a postal code |
+| `create_pickup` | Create a pickup/collection request (retiro) |
+| `list_pickups` | List pickup/collection requests |
+| `cancel_pickup` | Cancel a pickup/collection request |
+| `create_return` | Create a reverse logistics shipment (logística inversa / devolución) |
+| `list_returns` | List reverse logistics shipments (returns) |
+| `list_products` | List contracted products/services available on the account |
+| `get_invoice` | Get billing/invoice details |
 
 ## Auth
 
@@ -50,4 +63,20 @@ Uses **Bearer token** authentication. The server logs in with username/password
 
 ---
 
-**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:
+
+- `ANDREANI_API_KEY` *(required, secret)* — API key for Andreani
+- `ANDREANI_USER` *(required)* — Username for Andreani
+- `ANDREANI_PASSWORD` *(required, secret)* — Password for Andreani
+
+Issue credentials at the provider's developer portal: <https://developers.andreani.com>.
+
+## License
+
+MIT

package/dist/index.js

@@ -72,7 +72,10 @@ async function andreaniRequest(method, path, body) {
     }
     return res.json();
 }
-const server = new Server({ name: "mcp-andreani", 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-andreani", version: "0.2.0-alpha.2" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -503,7 +506,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-andreani", version: "0.2.0-alpha.1" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-andreani", 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-andreani",
-  "version": "0.2.0-alpha.1",
+  "version": "0.2.0-alpha.3",
   "description": "MCP server for Andreani — Argentine courier and logistics",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
     "mcp-andreani": "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": ["andreani", "courier", "logistics", "argentina", "shipping", "mcp"],
+  "keywords": [
+    "andreani",
+    "courier",
+    "logistics",
+    "argentina",
+    "shipping",
+    "mcp"
+  ],
   "mcpName": "io.github.codespar/mcp-andreani"
 }