@unclick/willyweather-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 @@
+# WillyWeather MCP by UnClick
+
+Australian weather, surf, and tide forecasts from WillyWeather.
+
+> 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": {
+    "willyweather": {
+      "command": "npx",
+      "args": ["-y", "https://github.com/malamutemayhem/unclick/releases/download/standalone-mcps-latest/willyweather.tgz"]
+    }
+  }
+}
+```
+
+## Tools
+
+- `willyweather_forecast`
+- `willyweather_surf`
+- `willyweather_tide`
+
+## 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,83 @@
+#!/usr/bin/env node
+// WillyWeather 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 { getWillyweatherForecast, getWillyweatherSurf, getWillyweatherTide, } from "./willyweather-tool.js";
+const TOOLS = [
+    {
+        name: "willyweather_forecast",
+        description: "Get weather forecast from WillyWeather for an Australian location.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                location_id: { type: "number", description: "WillyWeather location ID" },
+                days: { type: "number" },
+                api_key: { type: "string" },
+            },
+            required: ["location_id"],
+        },
+    },
+    {
+        name: "willyweather_surf",
+        description: "Get surf report from WillyWeather.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                location_id: { type: "number" },
+                days: { type: "number" },
+                api_key: { type: "string" },
+            },
+            required: ["location_id"],
+        },
+    },
+    {
+        name: "willyweather_tide",
+        description: "Get tide times from WillyWeather.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                location_id: { type: "number" },
+                days: { type: "number" },
+                api_key: { type: "string" },
+            },
+            required: ["location_id"],
+        },
+    }
+];
+const HANDLERS = {
+    willyweather_forecast: (args) => getWillyweatherForecast(args),
+    willyweather_surf: (args) => getWillyweatherSurf(args),
+    willyweather_tide: (args) => getWillyweatherTide(args),
+};
+const server = new Server({ name: "io.github.malamutemayhem/willyweather", 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(`[willyweather-mcp] fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});

package/dist/willyweather-tool.js

@@ -0,0 +1,127 @@
+// WillyWeather AU integration.
+// Australian weather, surf, tide, UV, and swell forecasts.
+// Docs: https://www.willyweather.com.au/api/docs/v2.html
+// Auth: WILLYWEATHER_KEY env var (passed as key query param in base URL).
+// Base URL: https://api.willyweather.com.au/v2/{key}/
+const WILLY_BASE = "https://api.willyweather.com.au/v2";
+function getApiKey(args) {
+    const key = String(args.api_key ?? process.env.WILLYWEATHER_KEY ?? "").trim();
+    if (!key)
+        throw new Error("api_key is required (or set WILLYWEATHER_KEY env var).");
+    return key;
+}
+async function willyGet(apiKey, path, params) {
+    const qs = params ? "?" + new URLSearchParams(params).toString() : "";
+    const res = await fetch(`${WILLY_BASE}/${apiKey}${path}${qs}`, {
+        headers: { "User-Agent": "UnClickMCP/1.0 (https://unclick.io)" },
+    });
+    if (res.status === 401 || res.status === 403)
+        throw new Error("Invalid WillyWeather API key.");
+    if (res.status === 404)
+        throw new Error("Location not found.");
+    if (res.status === 429)
+        throw new Error("WillyWeather API rate limit exceeded.");
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`WillyWeather HTTP ${res.status}${body ? `: ${body.slice(0, 200)}` : ""}`);
+    }
+    return res.json();
+}
+async function searchLocation(apiKey, query) {
+    const data = await willyGet(apiKey, "/search.json", { q: query, limit: "1" });
+    const locations = data["locations"];
+    if (!locations?.length)
+        return null;
+    const loc = locations[0];
+    return {
+        id: Number(loc["id"]),
+        name: String(loc["name"] ?? ""),
+        state: String(loc["state"]?.["abbreviation"] ?? ""),
+    };
+}
+// ─── get_willyweather_forecast ────────────────────────────────────────────────
+export async function getWillyweatherForecast(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const query = String(args.location ?? args.suburb ?? args.postcode ?? "").trim();
+        if (!query)
+            return { error: "location is required (suburb name or postcode)." };
+        const loc = await searchLocation(apiKey, query);
+        if (!loc)
+            return { error: `Location "${query}" not found in WillyWeather.` };
+        const days = Math.min(7, Math.max(1, Number(args.days ?? 3)));
+        const data = await willyGet(apiKey, `/locations/${loc.id}/weather.json`, {
+            forecasts: "weather,temperature,rainfall,wind,sunrisesunset",
+            days: String(days),
+        });
+        const forecasts = data["forecasts"];
+        return {
+            location: `${loc.name}, ${loc.state}`,
+            location_id: loc.id,
+            days_requested: days,
+            weather: forecasts?.["weather"],
+            temperature: forecasts?.["temperature"],
+            rainfall: forecasts?.["rainfall"],
+            wind: forecasts?.["wind"],
+            sunrise_sunset: forecasts?.["sunrisesunset"],
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ─── get_willyweather_surf ────────────────────────────────────────────────────
+export async function getWillyweatherSurf(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const query = String(args.location ?? args.suburb ?? args.postcode ?? "").trim();
+        if (!query)
+            return { error: "location is required (suburb name or postcode)." };
+        const loc = await searchLocation(apiKey, query);
+        if (!loc)
+            return { error: `Location "${query}" not found in WillyWeather.` };
+        const days = Math.min(7, Math.max(1, Number(args.days ?? 3)));
+        const data = await willyGet(apiKey, `/locations/${loc.id}/weather.json`, {
+            forecasts: "swell,surfConditions",
+            days: String(days),
+        });
+        const forecasts = data["forecasts"];
+        return {
+            location: `${loc.name}, ${loc.state}`,
+            location_id: loc.id,
+            days_requested: days,
+            swell: forecasts?.["swell"],
+            surf_conditions: forecasts?.["surfConditions"],
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ─── get_willyweather_tide ────────────────────────────────────────────────────
+export async function getWillyweatherTide(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const query = String(args.location ?? args.suburb ?? args.postcode ?? "").trim();
+        if (!query)
+            return { error: "location is required (suburb name or postcode)." };
+        const loc = await searchLocation(apiKey, query);
+        if (!loc)
+            return { error: `Location "${query}" not found in WillyWeather.` };
+        const days = Math.min(7, Math.max(1, Number(args.days ?? 2)));
+        const data = await willyGet(apiKey, `/locations/${loc.id}/weather.json`, {
+            forecasts: "tides",
+            days: String(days),
+        });
+        const forecasts = data["forecasts"];
+        return {
+            location: `${loc.name}, ${loc.state}`,
+            location_id: loc.id,
+            days_requested: days,
+            tides: forecasts?.["tides"],
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@unclick/willyweather-mcp",
+  "version": "0.1.0",
+  "mcpName": "io.github.malamutemayhem/willyweather",
+  "description": "Australian weather, surf, and tide forecasts from WillyWeather. By UnClick (https://unclick.world).",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "unclick",
+    "willyweather",
+    "weather",
+    "surf",
+    "tide",
+    "australia"
+  ],
+  "author": "UnClick (https://unclick.world)",
+  "type": "module",
+  "bin": {
+    "willyweather-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/willyweather-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/willyweather",
+  "title": "WillyWeather MCP by UnClick",
+  "description": "Australian weather, surf, and tide forecasts from WillyWeather. 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/willyweather-mcp"
+  },
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@unclick/willyweather-mcp",
+      "version": "0.1.0",
+      "runtimeHint": "npx",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}