@unclick/sendle-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+Apache License 2.0
+
+Copyright (c) 2026 UnClick / malamutemayhem
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,35 @@
+# Sendle MCP by UnClick
+
+Sendle shipping quotes, orders, and parcel tracking.
+
+> By UnClick. 180+ tools plus persistent agent memory in one install: https://unclick.world
+
+## Install
+
+Installs straight from GitHub, no npm account needed.
+
+```json
+{
+  "mcpServers": {
+    "sendle": {
+      "command": "npx",
+      "args": ["-y", "https://github.com/malamutemayhem/unclick/releases/download/standalone-mcps-latest/sendle.tgz"]
+    }
+  }
+}
+```
+
+## Tools
+
+- `sendle_get_quote`
+- `sendle_create_order`
+- `sendle_track_parcel`
+
+## Want the rest?
+
+This is one connector. [UnClick](https://unclick.world) bundles 180+ tools plus
+persistent cross-session agent memory in a single install.
+
+## License
+
+Apache-2.0

package/dist/index.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+// Sendle MCP. Standalone MCP server by UnClick.
+// By UnClick. 180+ tools plus persistent agent memory in one install: https://unclick.world
+//
+// Generated from the UnClick connector by scripts/generate-standalone-mcp.mjs.
+// Edit the connector in the UnClick monorepo, not here.
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { getSendleQuote, createSendleOrder, trackSendleParcel, } from "./sendle-tool.js";
+const TOOLS = [
+    {
+        name: "sendle_get_quote",
+        description: "Get a shipping quote from Sendle.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                pickup_suburb: { type: "string" },
+                pickup_postcode: { type: "string" },
+                pickup_country: { type: "string" },
+                delivery_suburb: { type: "string" },
+                delivery_postcode: { type: "string" },
+                delivery_country: { type: "string" },
+                weight_value: { type: "number" },
+                weight_units: { type: "string" },
+                api_key: { type: "string" },
+            },
+            required: ["pickup_postcode", "delivery_postcode", "weight_value"],
+        },
+    },
+    {
+        name: "sendle_create_order",
+        description: "Create a Sendle shipping order.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                sender: { type: "object", additionalProperties: true },
+                receiver: { type: "object", additionalProperties: true },
+                parcel_contents: { type: "array", items: {} },
+                api_key: { type: "string" },
+            },
+            required: ["sender", "receiver"],
+        },
+    },
+    {
+        name: "sendle_track_parcel",
+        description: "Track a Sendle parcel by tracking number.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                tracking_id: { type: "string" },
+                api_key: { type: "string" },
+            },
+            required: ["tracking_id"],
+        },
+    }
+];
+const HANDLERS = {
+    sendle_get_quote: (args) => getSendleQuote(args),
+    sendle_create_order: (args) => createSendleOrder(args),
+    sendle_track_parcel: (args) => trackSendleParcel(args),
+};
+const server = new Server({ name: "io.github.malamutemayhem/sendle", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const handler = HANDLERS[req.params.name];
+    if (!handler) {
+        return { content: [{ type: "text", text: `Unknown tool: ${req.params.name}` }], isError: true };
+    }
+    try {
+        const result = await handler((req.params.arguments ?? {}));
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: message }], isError: true };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    process.stderr.write(`[sendle-mcp] fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});

package/dist/sendle-tool.js

@@ -0,0 +1,145 @@
+// Sendle AU courier integration.
+// Quote, order, and track domestic and international courier shipments.
+// Docs: https://developers.sendle.com/
+// Auth: SENDLE_ID + SENDLE_API_KEY env vars (HTTP Basic Auth).
+// Base URL: https://api.sendle.com/api/
+const SENDLE_BASE = "https://api.sendle.com/api";
+function getAuth(args) {
+    const id = String(args.sendle_id ?? process.env.SENDLE_ID ?? "").trim();
+    const key = String(args.api_key ?? process.env.SENDLE_API_KEY ?? "").trim();
+    if (!id)
+        throw new Error("sendle_id is required (or set SENDLE_ID env var).");
+    if (!key)
+        throw new Error("api_key is required (or set SENDLE_API_KEY env var).");
+    return { id, key };
+}
+function basicAuth(auth) {
+    return "Basic " + Buffer.from(`${auth.id}:${auth.key}`).toString("base64");
+}
+async function sendleFetch(auth, path, method = "GET", body) {
+    const res = await fetch(`${SENDLE_BASE}${path}`, {
+        method,
+        headers: {
+            Authorization: basicAuth(auth),
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        },
+        ...(body ? { body: JSON.stringify(body) } : {}),
+    });
+    if (res.status === 401 || res.status === 403)
+        throw new Error("Invalid Sendle credentials.");
+    if (res.status === 404)
+        throw new Error("Resource not found.");
+    if (res.status === 422) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`Sendle validation error: ${text.slice(0, 300)}`);
+    }
+    if (res.status === 429)
+        throw new Error("Sendle API rate limit exceeded.");
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`Sendle API HTTP ${res.status}${text ? `: ${text.slice(0, 200)}` : ""}`);
+    }
+    return res.json();
+}
+// ─── get_sendle_quote ─────────────────────────────────────────────────────────
+export async function getSendleQuote(args) {
+    try {
+        const auth = getAuth(args);
+        const pickupPostcode = String(args.pickup_postcode ?? "").trim();
+        const deliveryPostcode = String(args.delivery_postcode ?? "").trim();
+        if (!pickupPostcode)
+            return { error: "pickup_postcode is required." };
+        if (!deliveryPostcode)
+            return { error: "delivery_postcode is required." };
+        const params = new URLSearchParams({
+            "pickup_suburb": String(args.pickup_suburb ?? ""),
+            "pickup_postcode": pickupPostcode,
+            "pickup_country": String(args.pickup_country ?? "AU"),
+            "delivery_suburb": String(args.delivery_suburb ?? ""),
+            "delivery_postcode": deliveryPostcode,
+            "delivery_country": String(args.delivery_country ?? "AU"),
+            "weight_value": String(args.weight_kg ?? "1"),
+            "weight_units": "kg",
+        });
+        if (args.volume_l)
+            params.set("volume_value", String(args.volume_l));
+        if (args.volume_l)
+            params.set("volume_units", "l");
+        const data = await sendleFetch(auth, `/quote?${params}`);
+        return {
+            pickup_postcode: pickupPostcode,
+            delivery_postcode: deliveryPostcode,
+            weight_kg: args.weight_kg ?? 1,
+            quotes: Array.isArray(data)
+                ? data.map((q) => ({
+                    plan: q["plan_name"],
+                    product: q["product"],
+                    eta_days_min: q["eta"]?.["days_range"]?.[0],
+                    eta_days_max: q["eta"]?.["days_range"]?.[1],
+                    price_aud: q["quote"]?.["gross"],
+                    price_aud_tax: q["quote"]?.["tax"],
+                }))
+                : [],
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ─── create_sendle_order ──────────────────────────────────────────────────────
+export async function createSendleOrder(args) {
+    try {
+        const auth = getAuth(args);
+        const body = {
+            pickup_date: args.pickup_date,
+            description: args.description ?? "Parcel",
+            weight: { value: Number(args.weight_kg ?? 1), units: "kg" },
+            sender: args.sender,
+            receiver: args.receiver,
+        };
+        if (args.customer_reference)
+            body["customer_reference"] = args.customer_reference;
+        if (args.metadata)
+            body["metadata"] = args.metadata;
+        const data = await sendleFetch(auth, "/orders", "POST", body);
+        return {
+            order_id: data["order_id"],
+            state: data["state"],
+            tracking_url: data["tracking_url"],
+            label_url: data["labels"]?.[0]?.["url"],
+            sendle_reference: data["sendle_reference"],
+            customer_reference: data["customer_reference"],
+            pickup_date: data["pickup_date"],
+            eta: data["eta"],
+            price_aud: data["quote"]?.["gross"],
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ─── track_sendle_parcel ──────────────────────────────────────────────────────
+export async function trackSendleParcel(args) {
+    try {
+        const auth = getAuth(args);
+        const ref = String(args.tracking_ref ?? args.sendle_reference ?? "").trim();
+        if (!ref)
+            return { error: "tracking_ref is required (Sendle reference number)." };
+        const data = await sendleFetch(auth, `/tracking/${encodeURIComponent(ref)}`);
+        return {
+            tracking_ref: ref,
+            state: data["state"],
+            tracking_events: data["tracking_events"]?.map((e) => ({
+                event_type: e["event_type"],
+                description: e["description"],
+                scan_time: e["scan_time"],
+                location: e["location"],
+            })),
+            estimated_delivery: data["estimated_delivery"],
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@unclick/sendle-mcp",
+  "version": "0.1.0",
+  "mcpName": "io.github.malamutemayhem/sendle",
+  "description": "Sendle shipping quotes, orders, and parcel tracking. By UnClick (https://unclick.world).",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "unclick",
+    "sendle",
+    "shipping",
+    "parcel",
+    "australia"
+  ],
+  "author": "UnClick (https://unclick.world)",
+  "type": "module",
+  "bin": {
+    "sendle-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.15.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "@types/node": "^22.0.0"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/malamutemayhem/unclick.git",
+    "directory": "packages/standalone/sendle-mcp"
+  },
+  "homepage": "https://unclick.world"
+}

package/server.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.malamutemayhem/sendle",
+  "title": "Sendle MCP by UnClick",
+  "description": "Sendle shipping quotes, orders, and parcel tracking. By UnClick.",
+  "version": "0.1.0",
+  "websiteUrl": "https://unclick.world",
+  "icons": [
+    {
+      "src": "https://unclick.world/favicon.png",
+      "mimeType": "image/png",
+      "sizes": [
+        "512x512"
+      ]
+    }
+  ],
+  "repository": {
+    "url": "https://github.com/malamutemayhem/unclick.git",
+    "source": "github",
+    "subfolder": "packages/standalone/sendle-mcp"
+  },
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@unclick/sendle-mcp",
+      "version": "0.1.0",
+      "runtimeHint": "npx",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}