@unclick/mcp-server 0.1.0 → 0.2.0

package/dist/domain-tool.js

@@ -0,0 +1,155 @@
+// Domain.com.au integration.
+// Australian property listings, property details, and suburb statistics.
+// Docs: https://developer.domain.com.au/docs/
+// Auth: DOMAIN_API_KEY env var (X-Api-Key header).
+// Base URL: https://api.domain.com.au/v1/
+const DOMAIN_BASE = "https://api.domain.com.au/v1";
+function getApiKey(args) {
+    const key = String(args.api_key ?? process.env.DOMAIN_API_KEY ?? "").trim();
+    if (!key)
+        throw new Error("api_key is required (or set DOMAIN_API_KEY env var).");
+    return key;
+}
+async function domainFetch(apiKey, path, method = "GET", body) {
+    const res = await fetch(`${DOMAIN_BASE}${path}`, {
+        method,
+        headers: {
+            "X-Api-Key": apiKey,
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        },
+        ...(body ? { body: JSON.stringify(body) } : {}),
+    });
+    if (res.status === 401 || res.status === 403)
+        throw new Error("Invalid Domain API key.");
+    if (res.status === 404)
+        throw new Error("Resource not found.");
+    if (res.status === 429)
+        throw new Error("Domain API rate limit exceeded.");
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`Domain API HTTP ${res.status}${text ? `: ${text.slice(0, 200)}` : ""}`);
+    }
+    return res.json();
+}
+// ─── search_domain_listings ───────────────────────────────────────────────────
+export async function searchDomainListings(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const listingType = String(args.listing_type ?? "residential").toLowerCase();
+        const endpoint = listingType === "commercial"
+            ? "/listings/commercial/_search"
+            : "/listings/residential/_search";
+        const body = {};
+        if (args.suburb || args.postcode || args.state) {
+            const loc = {};
+            if (args.suburb)
+                loc["suburb"] = String(args.suburb);
+            if (args.postcode)
+                loc["postcode"] = String(args.postcode);
+            if (args.state)
+                loc["state"] = String(args.state);
+            body["locations"] = [loc];
+        }
+        if (args.property_types)
+            body["propertyTypes"] = args.property_types;
+        if (args.listing_types)
+            body["listingType"] = args.listing_types;
+        if (args.min_price)
+            body["minPrice"] = Number(args.min_price);
+        if (args.max_price)
+            body["maxPrice"] = Number(args.max_price);
+        if (args.min_bedrooms)
+            body["minBedrooms"] = Number(args.min_bedrooms);
+        if (args.max_bedrooms)
+            body["maxBedrooms"] = Number(args.max_bedrooms);
+        body["pageSize"] = Math.min(50, Number(args.page_size ?? 10));
+        if (args.page_number)
+            body["pageNumber"] = Number(args.page_number);
+        const data = await domainFetch(apiKey, endpoint, "POST", body);
+        return {
+            listing_type: listingType,
+            count: data.length,
+            results: data.map((item) => {
+                const listing = item["listing"] ?? item;
+                return {
+                    id: listing["id"],
+                    status: listing["status"],
+                    type: listing["type"],
+                    address: listing["addressParts"] ?? listing["address"],
+                    price: listing["price"] ?? listing["priceDetails"],
+                    bedrooms: listing["bedrooms"],
+                    bathrooms: listing["bathrooms"],
+                    carspaces: listing["carspaces"],
+                    property_types: listing["propertyTypes"],
+                    headline: listing["headline"],
+                    url: listing["url"],
+                    agency: listing["advertiser"]?.["name"],
+                };
+            }),
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ─── get_domain_property ─────────────────────────────────────────────────────
+export async function getDomainProperty(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const propertyId = String(args.property_id ?? "").trim();
+        if (!propertyId)
+            return { error: "property_id is required." };
+        const data = await domainFetch(apiKey, `/listings/${propertyId}`);
+        return {
+            id: data["id"],
+            status: data["status"],
+            type: data["type"],
+            address: data["addressParts"] ?? data["address"],
+            price: data["price"] ?? data["priceDetails"],
+            bedrooms: data["bedrooms"],
+            bathrooms: data["bathrooms"],
+            carspaces: data["carspaces"],
+            land_area_sqm: data["landAreaSqm"],
+            building_area_sqm: data["buildingAreaSqm"],
+            property_types: data["propertyTypes"],
+            headline: data["headline"],
+            description: data["description"],
+            url: data["url"],
+            listed_date: data["dateListed"],
+            agency: data["advertiser"],
+            features: data["features"],
+            inspection_times: data["inspectionSchedule"],
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ─── get_domain_suburb_stats ──────────────────────────────────────────────────
+export async function getDomainSuburbStats(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const suburb = String(args.suburb ?? "").trim();
+        const state = String(args.state ?? "").trim();
+        if (!suburb)
+            return { error: "suburb is required." };
+        if (!state)
+            return { error: "state is required (e.g. NSW, VIC, QLD)." };
+        const propertyCategory = String(args.property_category ?? "house").toLowerCase();
+        const bedrooms = args.bedrooms ? Number(args.bedrooms) : undefined;
+        const path = `/suburbPerformanceStatistics/${state}/${encodeURIComponent(suburb)}/${propertyCategory}${bedrooms !== undefined ? `/${bedrooms}` : ""}`;
+        const data = await domainFetch(apiKey, path);
+        return {
+            suburb,
+            state,
+            property_category: propertyCategory,
+            bedrooms: bedrooms ?? "all",
+            statistics: data,
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=domain-tool.js.map

package/dist/domain-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-tool.js","sourceRoot":"","sources":["../src/domain-tool.ts"],"names":[],"mappings":"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"}

package/dist/ebird-tool.d.ts

@@ -0,0 +1,5 @@
+export declare function getRecentObservations(args: Record<string, unknown>): Promise<unknown>;
+export declare function getNotableObservations(args: Record<string, unknown>): Promise<unknown>;
+export declare function getSpeciesInfo(args: Record<string, unknown>): Promise<unknown>;
+export declare function ebirdAction(action: string, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=ebird-tool.d.ts.map

package/dist/ebird-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ebird-tool.d.ts","sourceRoot":"","sources":["../src/ebird-tool.ts"],"names":[],"mappings":"AAuCA,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAiDlB;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CA8ClB;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CA6ClB;AAID,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAYlB"}

package/dist/ebird-tool.js

@@ -0,0 +1,128 @@
+// ─── eBird Bird Sightings ─────────────────────────────────────────────────────
+// Cornell Lab of Ornithology eBird API v2.
+// Auth: EBIRD_API_KEY env or api_key arg (X-eBirdApiToken header).
+// Docs: https://documenter.getpostman.com/view/664302/S1ENwy59
+const EBIRD_BASE = "https://api.ebird.org/v2";
+// ─── API helper ──────────────────────────────────────────────────────────────
+function getKey(args) {
+    const key = String(args.api_key ?? process.env.EBIRD_API_KEY ?? "").trim();
+    if (!key)
+        throw new Error("api_key is required (or set EBIRD_API_KEY env).");
+    return key;
+}
+async function ebirdFetch(path, params, apiKey) {
+    const url = new URL(`${EBIRD_BASE}${path}`);
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined && v !== "")
+            url.searchParams.set(k, v);
+    }
+    const res = await fetch(url.toString(), {
+        headers: {
+            "X-eBirdApiToken": apiKey,
+            "Accept": "application/json",
+        },
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`eBird API HTTP ${res.status}: ${text.slice(0, 200)}`);
+    }
+    return res.json();
+}
+// ─── Operations ──────────────────────────────────────────────────────────────
+export async function getRecentObservations(args) {
+    const apiKey = getKey(args);
+    const regionCode = String(args.region_code ?? "").trim().toUpperCase();
+    if (!regionCode)
+        throw new Error("region_code is required (e.g. 'US-NY', 'GB', 'AU-NSW').");
+    const back = String(Math.min(30, Math.max(1, Number(args.back ?? 7))));
+    const maxResults = String(Math.min(10000, Math.max(1, Number(args.max_results ?? 100))));
+    const params = { back, maxResults };
+    if (args.species_code)
+        params.speciesCode = String(args.species_code);
+    const data = await ebirdFetch(`/data/obs/${regionCode}/recent`, params, apiKey);
+    return {
+        region_code: regionCode,
+        back_days: Number(back),
+        count: data.length,
+        observations: data.map((o) => ({
+            species_code: o.speciesCode,
+            common_name: o.comName,
+            sci_name: o.sciName,
+            location: o.locName,
+            location_id: o.locId,
+            date: o.obsDt,
+            count: o.howMany ?? null,
+            lat: o.lat,
+            lon: o.lng,
+            valid: o.obsValid,
+            reviewed: o.obsReviewed,
+        })),
+    };
+}
+export async function getNotableObservations(args) {
+    const apiKey = getKey(args);
+    const regionCode = String(args.region_code ?? "").trim().toUpperCase();
+    if (!regionCode)
+        throw new Error("region_code is required (e.g. 'US-NY', 'GB').");
+    const back = String(Math.min(30, Math.max(1, Number(args.back ?? 7))));
+    const maxResults = String(Math.min(10000, Math.max(1, Number(args.max_results ?? 50))));
+    const detail = args.detail === "full" ? "full" : "simple";
+    const data = await ebirdFetch(`/data/obs/${regionCode}/recent/notable`, { back, maxResults, detail }, apiKey);
+    return {
+        region_code: regionCode,
+        back_days: Number(back),
+        count: data.length,
+        notable_birds: data.map((o) => ({
+            species_code: o.speciesCode,
+            common_name: o.comName,
+            sci_name: o.sciName,
+            location: o.locName,
+            location_id: o.locId,
+            date: o.obsDt,
+            count: o.howMany ?? null,
+            lat: o.lat,
+            lon: o.lng,
+            reviewed: o.obsReviewed,
+        })),
+    };
+}
+export async function getSpeciesInfo(args) {
+    const apiKey = getKey(args);
+    const speciesCode = String(args.species_code ?? "").trim().toLowerCase();
+    const locale = String(args.locale ?? "en").trim();
+    const params = { locale };
+    if (speciesCode)
+        params.species = speciesCode;
+    const data = await ebirdFetch("/ref/taxonomy/ebird", params, apiKey);
+    if (data.length === 0) {
+        return { error: `No taxonomy found for species_code: "${speciesCode}".` };
+    }
+    return {
+        count: data.length,
+        species: data.slice(0, 50).map((t) => ({
+            species_code: t.speciesCode,
+            common_name: t.comName,
+            sci_name: t.sciName,
+            category: t.category,
+            taxon_order: t.taxonOrder,
+            order: t.order ?? null,
+            family_sci_name: t.familySciName ?? null,
+            family_com_name: t.familyComName ?? null,
+            family_code: t.familyCode ?? null,
+        })),
+    };
+}
+// ─── Public dispatcher ────────────────────────────────────────────────────────
+export async function ebirdAction(action, args) {
+    switch (action) {
+        case "get_recent_observations": return getRecentObservations(args);
+        case "get_notable_observations": return getNotableObservations(args);
+        case "get_species_info": return getSpeciesInfo(args);
+        default:
+            return {
+                error: `Unknown eBird action: "${action}". ` +
+                    "Valid: get_recent_observations, get_notable_observations, get_species_info.",
+            };
+    }
+}
+//# sourceMappingURL=ebird-tool.js.map

package/dist/ebird-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ebird-tool.js","sourceRoot":"","sources":["../src/ebird-tool.ts"],"names":[],"mappings":"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"}

package/dist/email-tool.d.ts

@@ -0,0 +1,8 @@
+export declare function sendEmail(args: Record<string, unknown>): Promise<unknown>;
+export declare function readInbox(args: Record<string, unknown>): Promise<unknown>;
+export declare function searchEmail(args: Record<string, unknown>): Promise<unknown>;
+export declare function getEmail(args: Record<string, unknown>): Promise<unknown>;
+export declare function markRead(args: Record<string, unknown>): Promise<unknown>;
+export declare function deleteEmail(args: Record<string, unknown>): Promise<unknown>;
+export declare function emailAction(action: string, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=email-tool.d.ts.map

package/dist/email-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-tool.d.ts","sourceRoot":"","sources":["../src/email-tool.ts"],"names":[],"mappings":"AA+LA,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA8C/E;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAkC/E;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA8CjF;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAyB9E;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAgB9E;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAiDjF;AAID,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAelB"}