@virga-mcp/server 0.1.0

package/dist/prompts.js

@@ -0,0 +1,67 @@
+/**
+ * MCP prompt template registrations for the Virga Weather API.
+ */
+import { z } from "zod";
+export function registerPrompts(server) {
+    server.prompt("setup_weather_account", "Guided walkthrough to create a Virga Weather API account, accept terms, set up billing, and get a production API key", {}, async () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `I need to set up a Virga Weather API account. Please walk me through the complete onboarding process:
+
+1. Create an account by calling POST /api/v1/accounts with a name for my agent
+2. Read the terms of service from GET /api/v1/terms
+3. Accept the terms by calling POST /api/v1/terms/accept with the version
+4. Activate billing via POST /api/v1/billing/activate (I'll need to complete the checkout URL)
+5. Purchase credits via POST /api/v1/billing/credits with a bundle size
+6. Create a production API key via POST /api/v1/keys
+
+Please guide me through each step, showing the API calls and explaining what's happening. Start with step 1.`,
+                },
+            },
+        ],
+    }));
+    server.prompt("check_weather", "Check the current weather at a location — resolves place names to coordinates automatically", {
+        location: z
+            .string()
+            .describe('Place name, city, or address (e.g. "New York", "Tokyo", "London")'),
+    }, async ({ location }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `What's the weather like in ${location}? Use the search_location tool to find the coordinates, then use get_current_weather to get the current conditions. Give me a concise summary including temperature, conditions, humidity, and wind.`,
+                },
+            },
+        ],
+    }));
+    server.prompt("weather_forecast", "Get a weather forecast for a location — daily or hourly", {
+        location: z
+            .string()
+            .describe('Place name, city, or address (e.g. "Paris", "Sydney")'),
+        type: z
+            .enum(["daily", "hourly"])
+            .optional()
+            .describe("Forecast type: daily (default) or hourly"),
+    }, async ({ location, type }) => {
+        const forecastType = type ?? "daily";
+        const tool = forecastType === "hourly"
+            ? "get_hourly_forecast"
+            : "get_daily_forecast";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Get the ${forecastType} weather forecast for ${location}. Use search_location to find coordinates, then use ${tool} to get the forecast. Summarize the key trends — temperature changes, precipitation chances, and any notable weather events.`,
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,MAAM,CACX,uBAAuB,EACvB,sHAAsH,EACtH,EAAE,EACF,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;;;;;;;;;6GAS2F;iBAClG;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,eAAe,EACf,6FAA6F,EAC7F;QACE,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,CACP,mEAAmE,CACpE;KACJ,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QACvB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,8BAA8B,QAAQ,sMAAsM;iBACnP;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,kBAAkB,EAClB,yDAAyD,EACzD;QACE,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,CAAC,uDAAuD,CAAC;QACpE,IAAI,EAAE,CAAC;aACJ,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;aACzB,QAAQ,EAAE;aACV,QAAQ,CAAC,0CAA0C,CAAC;KACxD,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE;QAC3B,MAAM,YAAY,GAAG,IAAI,IAAI,OAAO,CAAC;QACrC,MAAM,IAAI,GACR,YAAY,KAAK,QAAQ;YACvB,CAAC,CAAC,qBAAqB;YACvB,CAAC,CAAC,oBAAoB,CAAC;QAC3B,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,WAAW,YAAY,yBAAyB,QAAQ,uDAAuD,IAAI,8HAA8H;qBACxP;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP resource registrations for the Virga Weather API.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { VirgaClient } from "./client.js";
+export declare function registerResources(server: McpServer, client: VirgaClient): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAmB/C,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,WAAW,GAClB,IAAI,CAmMN"}

package/dist/resources.js

@@ -0,0 +1,239 @@
+/**
+ * MCP resource registrations for the Virga Weather API.
+ */
+const CREDIT_COSTS = {
+    get_current_weather: { endpoint: "/api/v1/weather/current", credits: 1 },
+    get_hourly_forecast: {
+        endpoint: "/api/v1/weather/forecast/hourly",
+        credits: 2,
+    },
+    get_daily_forecast: {
+        endpoint: "/api/v1/weather/forecast/daily",
+        credits: 2,
+    },
+    get_historical_weather: {
+        endpoint: "/api/v1/weather/historical",
+        credits: 3,
+    },
+    search_location: { endpoint: "nominatim (free)", credits: 0 },
+};
+export function registerResources(server, client) {
+    server.resource("account-status", "weather://account/status", {
+        description: "Current account status including credit balance, rate limits, and usage summary",
+        mimeType: "application/json",
+    }, async (uri) => {
+        try {
+            const account = await client.getAccount();
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "application/json",
+                        text: JSON.stringify(account, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "text/plain",
+                        text: `Error fetching account status: ${msg}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.resource("terms", "weather://terms", {
+        description: "Current Virga Weather API terms of service",
+        mimeType: "application/json",
+    }, async (uri) => {
+        try {
+            const terms = await client.getTerms();
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "application/json",
+                        text: JSON.stringify(terms, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "text/plain",
+                        text: `Error fetching terms: ${msg}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.resource("pricing", "weather://pricing", {
+        description: "Credit costs per weather tool and available credit bundles",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const pricing = {
+            creditCosts: CREDIT_COSTS,
+            bundles: [
+                { name: "500", credits: 500, price: "$5.00" },
+                { name: "2000", credits: 2000, price: "$18.00" },
+                { name: "10000", credits: 10000, price: "$75.00" },
+            ],
+            notes: {
+                stage: "Stage environment is free — no credits consumed. Use for testing.",
+                production: "Production requests consume credits. Purchase bundles via the billing API.",
+            },
+        };
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(pricing, null, 2),
+                },
+            ],
+        };
+    });
+    server.resource("openapi", "weather://openapi", {
+        description: "Full OpenAPI 3.1 specification for the Virga Weather API — all endpoints, schemas, and authentication details",
+        mimeType: "application/json",
+    }, async (uri) => {
+        try {
+            const spec = await client.getOpenApiSpec();
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "application/json",
+                        text: spec,
+                    },
+                ],
+            };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "text/plain",
+                        text: `Error fetching OpenAPI spec: ${msg}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.resource("onboarding", "weather://onboarding", {
+        description: "Step-by-step instructions for autonomous agent onboarding — account creation, terms, billing, and first API call",
+        mimeType: "text/markdown",
+    }, async (uri) => {
+        const onboarding = ONBOARDING_GUIDE;
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "text/markdown",
+                    text: onboarding,
+                },
+            ],
+        };
+    });
+    server.resource("docs", "weather://docs", {
+        description: "Condensed LLM-friendly documentation for the Virga Weather API — endpoints, auth, response format, and error codes",
+        mimeType: "text/markdown",
+    }, async (uri) => {
+        try {
+            const docs = await client.getDocs();
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "text/markdown",
+                        text: docs,
+                    },
+                ],
+            };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "text/plain",
+                        text: `Error fetching docs: ${msg}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+const ONBOARDING_GUIDE = `# Virga Weather API — Agent Onboarding
+
+Follow these steps to set up your account and start querying weather data.
+
+## Step 1: Create Account
+\`\`\`
+POST /api/v1/accounts
+Body: {"name": "your-agent-name"}
+\`\`\`
+Returns: \`{accountId, apiKey}\` — the apiKey is a stage key (free, no credits needed).
+
+## Step 2: Read Terms
+\`\`\`
+GET /api/v1/terms
+Header: X-API-Key: <your-stage-key>
+\`\`\`
+Returns the current terms of service text and version.
+
+## Step 3: Accept Terms
+\`\`\`
+POST /api/v1/terms/accept
+Header: X-API-Key: <your-stage-key>
+Body: {"version": "<version-from-step-2>"}
+\`\`\`
+
+## Step 4: Activate Billing
+\`\`\`
+POST /api/v1/billing/activate
+Header: X-API-Key: <your-stage-key>
+\`\`\`
+Returns a Stripe checkout URL. Complete payment method setup at that URL.
+
+## Step 5: Purchase Credits
+\`\`\`
+POST /api/v1/billing/credits
+Header: X-API-Key: <your-stage-key>
+Body: {"bundle": "500"}
+\`\`\`
+Bundles: 500 credits ($5), 2000 ($18), 10000 ($75).
+Returns a Stripe checkout URL to complete the purchase.
+
+## Step 6: Create Production Key
+\`\`\`
+POST /api/v1/keys
+Header: X-API-Key: <your-stage-key>
+Body: {"name": "production", "environment": "production"}
+\`\`\`
+Requires: terms accepted + billing activated + positive credit balance.
+
+## Step 7: Query Weather
+\`\`\`
+GET /api/v1/weather/current?lat=40.7128&lon=-74.0060
+Header: X-API-Key: <your-production-key>
+\`\`\`
+
+## Notes
+- Stage keys are free with lower rate limits (10 req/min, 500/day).
+- Production keys consume credits but have higher limits (60 req/min, 10000/day).
+- You can also use the MCP tools directly — they handle the API calls for you.
+`;
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP tool registrations for the Virga Weather API.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { VirgaClient } from "./client.js";
+export declare function registerTools(server: McpServer, client: VirgaClient): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAyB/C,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CA4Y1E"}

package/dist/tools.js

@@ -0,0 +1,326 @@
+/**
+ * MCP tool registrations for the Virga Weather API.
+ */
+import { z } from "zod";
+const latSchema = z
+    .number()
+    .min(-90)
+    .max(90)
+    .describe("Latitude (-90 to 90)");
+const lonSchema = z
+    .number()
+    .min(-180)
+    .max(180)
+    .describe("Longitude (-180 to 180)");
+function formatWeatherSummary(data) {
+    return JSON.stringify(data, null, 2);
+}
+function jsonResult(data) {
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(data, null, 2) },
+        ],
+    };
+}
+export function registerTools(server, client) {
+    server.tool("get_current_weather", "Get current weather conditions for a location. Returns temperature, humidity, wind, precipitation, and conditions.", { lat: latSchema, lon: lonSchema }, async ({ lat, lon }) => {
+        try {
+            const result = await client.getCurrentWeather(lat, lon);
+            return {
+                content: [
+                    { type: "text", text: formatWeatherSummary(result) },
+                ],
+            };
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    });
+    server.tool("get_hourly_forecast", "Get hourly weather forecast for a location. Returns up to 120 hours of forecast data.", {
+        lat: latSchema,
+        lon: lonSchema,
+        hours: z
+            .number()
+            .int()
+            .min(1)
+            .max(120)
+            .optional()
+            .describe("Number of hours to forecast (1-120, default 24)"),
+    }, async ({ lat, lon, hours }) => {
+        try {
+            const result = await client.getHourlyForecast(lat, lon, hours);
+            return {
+                content: [
+                    { type: "text", text: formatWeatherSummary(result) },
+                ],
+            };
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    });
+    server.tool("get_daily_forecast", "Get daily weather forecast for a location. Returns up to 16 days of forecast data.", {
+        lat: latSchema,
+        lon: lonSchema,
+        days: z
+            .number()
+            .int()
+            .min(1)
+            .max(16)
+            .optional()
+            .describe("Number of days to forecast (1-16, default 7)"),
+    }, async ({ lat, lon, days }) => {
+        try {
+            const result = await client.getDailyForecast(lat, lon, days);
+            return {
+                content: [
+                    { type: "text", text: formatWeatherSummary(result) },
+                ],
+            };
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    });
+    server.tool("get_historical_weather", "Get historical weather data for a location on a specific date. Returns temperature, humidity, wind, and conditions for that date.", {
+        lat: latSchema,
+        lon: lonSchema,
+        date: z
+            .string()
+            .describe("Date to retrieve weather for (ISO 8601 format, e.g. 2026-01-15)"),
+    }, async ({ lat, lon, date }) => {
+        try {
+            const result = await client.getHistoricalWeather(lat, lon, date);
+            return {
+                content: [
+                    { type: "text", text: formatWeatherSummary(result) },
+                ],
+            };
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    });
+    server.tool("search_location", "Geocode a place name to latitude/longitude coordinates. Use this to convert city names, addresses, or landmarks into coordinates for weather queries.", {
+        query: z
+            .string()
+            .describe('Place name, city, or address to geocode (e.g. "New York", "Tokyo, Japan", "1600 Pennsylvania Ave")'),
+    }, async ({ query }) => {
+        try {
+            const url = `https://nominatim.openstreetmap.org/search?q=${encodeURIComponent(query)}&format=json&limit=5`;
+            const res = await fetch(url, {
+                headers: {
+                    "User-Agent": "virga-mcp/0.1.0",
+                },
+            });
+            if (!res.ok) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Geocoding request failed with status ${res.status}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const results = (await res.json());
+            if (results.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `No locations found for "${query}". Try a more specific search.`,
+                        },
+                    ],
+                };
+            }
+            const locations = results.map((r) => ({
+                lat: parseFloat(r.lat),
+                lon: parseFloat(r.lon),
+                name: r.display_name,
+                type: r.type,
+            }));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(locations, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    });
+    // --- Account Management ---
+    server.tool("create_account", "Create a new Virga Weather API account. Returns a stage API key for testing. No authentication required.", {
+        name: z
+            .string()
+            .describe("Name for your account or agent (e.g. 'my-weather-bot')"),
+    }, async ({ name }) => {
+        try {
+            const result = await client.createAccount(name);
+            return jsonResult(result);
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    });
+    server.tool("accept_terms", "Accept the Virga Weather API terms of service. Required before creating production keys.", {
+        version: z
+            .string()
+            .describe("Terms version to accept (get the current version from get_terms or the weather://terms resource)"),
+    }, async ({ version }) => {
+        try {
+            const result = await client.acceptTerms(version);
+            return jsonResult(result);
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    });
+    server.tool("activate_billing", "Set up a payment method via Stripe. Returns a checkout URL that must be opened in a browser to complete setup. Required before purchasing credits.", {}, async () => {
+        try {
+            const result = await client.activateBilling();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            ...result,
+                            note: "Open the checkoutUrl in a browser to complete payment method setup.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    });
+    server.tool("purchase_credits", "Purchase a credit bundle. Returns a Stripe checkout URL to complete the purchase. Bundles: 500 credits ($5), 2000 ($18), 10000 ($75).", {
+        bundle: z
+            .enum(["500", "2000", "10000"])
+            .describe("Credit bundle size: '500' ($5), '2000' ($18), or '10000' ($75)"),
+    }, async ({ bundle }) => {
+        try {
+            const result = await client.purchaseCredits(bundle);
+            const prices = {
+                "500": "$5.00",
+                "2000": "$18.00",
+                "10000": "$75.00",
+            };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            ...result,
+                            bundle,
+                            price: prices[bundle],
+                            note: "Open the checkoutUrl in a browser to complete the purchase.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    });
+    server.tool("get_billing_status", "Get current billing status including credit balance, spend caps, and auto-topup configuration.", {}, async () => {
+        try {
+            const result = await client.getBillingStatus();
+            return jsonResult(result);
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    });
+    server.tool("list_api_keys", "List all API keys for the account. Shows key prefix, environment, status, and last used timestamp.", {}, async () => {
+        try {
+            const result = await client.listApiKeys();
+            return jsonResult(result);
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    });
+    server.tool("create_api_key", "Create a new API key. Production keys require accepted terms, activated billing, and positive credit balance.", {
+        name: z.string().describe("Descriptive name for the key (e.g. 'production-bot')"),
+        environment: z
+            .enum(["stage", "production"])
+            .optional()
+            .describe("Key environment: 'stage' (free, lower limits) or 'production' (uses credits, higher limits). Default: stage."),
+    }, async ({ name, environment }) => {
+        try {
+            const result = await client.createApiKey(name, environment);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            ...result,
+                            warning: "Store this API key securely — it will not be shown again. Only the key prefix is stored for display.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    });
+    server.tool("revoke_api_key", "Revoke an API key. WARNING: This is a destructive operation — the key will immediately stop working and cannot be restored.", {
+        keyId: z.string().describe("ID of the key to revoke (get from list_api_keys)"),
+    }, async ({ keyId }) => {
+        try {
+            const result = await client.revokeApiKey(keyId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            ...result,
+                            warning: "Key has been permanently revoked. Any systems using this key will lose access.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    });
+    server.tool("get_usage", "Get API usage history for the account. Shows endpoint calls, credit costs, and timestamps.", {
+        startDate: z
+            .string()
+            .optional()
+            .describe("Start date for usage query (ISO 8601 format)"),
+        endDate: z
+            .string()
+            .optional()
+            .describe("End date for usage query (ISO 8601 format)"),
+    }, async ({ startDate, endDate }) => {
+        try {
+            const result = await client.getUsage({
+                start: startDate,
+                end: endDate,
+            });
+            return jsonResult(result);
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    });
+}
+function errorResult(e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    return {
+        content: [{ type: "text", text: `Error: ${msg}` }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=tools.js.map