@virga-mcp/server 0.1.0

package/README.md

@@ -0,0 +1,192 @@
+# @virga-mcp/server
+
+MCP (Model Context Protocol) server for the [Virga Weather API](https://api.virga.dev). Exposes weather data as native tools for LLM clients.
+
+## Quick Start
+
+### Claude Code
+
+```bash
+claude mcp add --transport stdio --env VIRGA_API_KEY=sk_virga_prod_xxx virga-weather -- npx -y @virga-mcp/server
+```
+
+### Codex CLI
+
+```bash
+codex mcp add virga-weather --env VIRGA_API_KEY=sk_virga_prod_xxx -- npx -y @virga-mcp/server
+```
+
+### Gemini CLI
+
+```bash
+gemini mcp add virga-weather -- npx -y @virga-mcp/server --api-key sk_virga_prod_xxx
+```
+
+Or add to `~/.gemini/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "virga-weather": {
+      "command": "npx",
+      "args": ["-y", "@virga-mcp/server", "--api-key", "sk_virga_prod_xxx"]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to your config file:
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "virga-weather": {
+      "command": "npx",
+      "args": ["-y", "@virga-mcp/server"],
+      "env": {
+        "VIRGA_API_KEY": "sk_virga_prod_xxx"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add as an MCP server in Cursor settings (Settings > MCP Servers), or add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "virga-weather": {
+      "command": "npx",
+      "args": ["-y", "@virga-mcp/server", "--api-key", "sk_virga_prod_xxx"]
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add to your MCP configuration:
+
+```json
+{
+  "virga-weather": {
+    "command": "npx",
+    "args": ["-y", "@virga-mcp/server", "--api-key", "sk_virga_prod_xxx"]
+  }
+}
+```
+
+### OpenCode
+
+Add to `opencode.json`:
+
+```json
+{
+  "mcp": {
+    "virga-weather": {
+      "type": "local",
+      "command": ["npx", "-y", "@virga-mcp/server"],
+      "environment": {
+        "VIRGA_API_KEY": "sk_virga_prod_xxx"
+      }
+    }
+  }
+}
+```
+
+### Xcode (26.3+)
+
+Xcode 26.3 has native MCP support. Add to your Xcode MCP configuration:
+
+```json
+{
+  "servers": {
+    "virga-weather": {
+      "command": "npx",
+      "arguments": ["-y", "@virga-mcp/server"],
+      "environment": {
+        "VIRGA_API_KEY": "sk_virga_prod_xxx"
+      }
+    }
+  }
+}
+```
+
+### Environment Variable
+
+You can also set the API key as an environment variable instead of passing it as a flag:
+
+```bash
+VIRGA_API_KEY=sk_virga_prod_xxx npx @virga-mcp/server
+```
+
+## Weather Tools
+
+| Tool | Description | Credits |
+|------|-------------|---------|
+| `get_current_weather` | Current weather conditions for a lat/lon | 1 |
+| `get_hourly_forecast` | Hourly forecast (1-120 hours) | 2 |
+| `get_daily_forecast` | Daily forecast (1-16 days) | 2 |
+| `get_historical_weather` | Historical weather for a specific date | 3 |
+| `search_location` | Geocode a place name to lat/lon | 0 (free) |
+
+## Account & Billing Tools
+
+| Tool | Description |
+|------|-------------|
+| `create_account` | Create a new account, get a stage API key |
+| `accept_terms` | Accept the current terms of service |
+| `activate_billing` | Set up payment method (returns Stripe checkout URL) |
+| `purchase_credits` | Buy a credit bundle (returns Stripe checkout URL) |
+| `get_billing_status` | Credit balance, spend caps, auto-topup config |
+| `list_api_keys` | List all API keys for the account |
+| `create_api_key` | Create a new API key (stage or production) |
+| `revoke_api_key` | Permanently revoke an API key |
+| `get_usage` | API usage history with credit costs |
+
+## Resources
+
+| Resource | URI | Description |
+|----------|-----|-------------|
+| Account Status | `weather://account/status` | Credit balance, rate limits, usage |
+| Terms | `weather://terms` | Current terms of service |
+| Pricing | `weather://pricing` | Credit costs per tool and bundles |
+| OpenAPI Spec | `weather://openapi` | Full OpenAPI 3.1 specification |
+| Onboarding | `weather://onboarding` | Step-by-step autonomous setup guide |
+| Docs | `weather://docs` | Condensed LLM-friendly documentation |
+
+## Prompt Templates
+
+| Prompt | Description |
+|--------|-------------|
+| `setup_weather_account` | Guided walkthrough for account creation and billing setup |
+| `check_weather` | Check current weather at a location by name |
+| `weather_forecast` | Get a daily or hourly forecast for a location |
+
+## CLI Options
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--api-key <key>` | Virga API key | `VIRGA_API_KEY` env var |
+| `--base-url <url>` | API base URL | `https://api.virga.dev` |
+| `--help` | Show help | |
+| `--version` | Show version | |
+
+## Getting an API Key
+
+Use the `setup_weather_account` prompt template, or follow these steps:
+
+1. Create an account: `POST https://api.virga.dev/api/v1/accounts`
+2. Accept terms: `POST https://api.virga.dev/api/v1/terms/accept`
+3. Set up billing: `POST https://api.virga.dev/api/v1/billing/activate`
+4. Purchase credits: `POST https://api.virga.dev/api/v1/billing/credits`
+5. Create a production key: `POST https://api.virga.dev/api/v1/keys`
+
+Or use a stage key (free, no credits required) for testing.

package/dist/client.d.ts

@@ -0,0 +1,170 @@
+/**
+ * HTTP client for the Virga Weather API.
+ */
+export interface VirgaClientConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+export declare class VirgaClient {
+    private apiKey;
+    private baseUrl;
+    constructor(config: VirgaClientConfig);
+    private request;
+    getCurrentWeather(lat: number, lon: number): Promise<WeatherResponse>;
+    getHourlyForecast(lat: number, lon: number, hours?: number): Promise<ForecastResponse>;
+    getDailyForecast(lat: number, lon: number, days?: number): Promise<ForecastResponse>;
+    getHistoricalWeather(lat: number, lon: number, date: string): Promise<WeatherResponse>;
+    createAccount(name: string): Promise<CreateAccountResponse>;
+    getAccount(): Promise<AccountResponse>;
+    getUsage(options?: {
+        start?: string;
+        end?: string;
+        limit?: number;
+    }): Promise<UsageResponse>;
+    listApiKeys(): Promise<ApiKeysResponse>;
+    createApiKey(name: string, environment?: string): Promise<CreateApiKeyResponse>;
+    revokeApiKey(keyId: string): Promise<{
+        message: string;
+    }>;
+    getTerms(): Promise<TermsResponse>;
+    acceptTerms(version: string): Promise<{
+        message: string;
+    }>;
+    getOpenApiSpec(): Promise<string>;
+    getDocs(): Promise<string>;
+    activateBilling(): Promise<{
+        checkoutUrl: string;
+    }>;
+    purchaseCredits(bundle: string): Promise<{
+        checkoutUrl: string;
+    }>;
+    getBillingStatus(): Promise<BillingStatusResponse>;
+    private requestNoAuth;
+}
+export declare class VirgaApiError extends Error {
+    status: number;
+    code: string;
+    constructor(message: string, status: number, code: string);
+}
+export interface NormalizedWeather {
+    temperature: {
+        current: number;
+        feelsLike: number;
+        min: number;
+        max: number;
+        unit: string;
+    };
+    humidity: number;
+    pressure: number;
+    wind: {
+        speed: number;
+        direction: number;
+        gust: number | null;
+        unit: string;
+    };
+    precipitation: {
+        probability: number | null;
+        amount: number;
+        unit: string;
+    };
+    conditions: {
+        code: number;
+        description: string;
+        icon: string;
+    };
+    visibility: number;
+    uv: number | null;
+    clouds: number;
+}
+export interface WeatherMeta {
+    source: string;
+    upstreamTimestamp: string;
+    cacheTTL: number;
+    cached: boolean;
+    confidence: number;
+    creditsCost: number;
+    creditsRemaining: number;
+    environment: string;
+    rateLimitRemaining: number;
+    rateLimitReset: number;
+}
+export interface Location {
+    lat: number;
+    lon: number;
+    name: string | null;
+}
+export interface WeatherResponse {
+    data: NormalizedWeather;
+    location: Location;
+    timestamp: string;
+    meta: WeatherMeta;
+}
+export interface ForecastResponse {
+    data: NormalizedWeather[];
+    location: Location;
+    meta: WeatherMeta;
+}
+export interface AccountResponse {
+    accountId: string;
+    name: string;
+    email?: string;
+    environment: string;
+    status: string;
+    termsAcceptedVersion?: string;
+    billingActivated: boolean;
+    creditBalance: number;
+    dailySpendCap: number;
+    monthlySpendCap: number;
+    createdAt: number;
+    activeKeyCount: number;
+}
+export interface UsageResponse {
+    usage: Array<{
+        endpoint: string;
+        creditsCost: number;
+        timestamp: number;
+        cached: boolean;
+        environment: string;
+    }>;
+}
+export interface TermsResponse {
+    version: string;
+    text: string;
+    accepted: boolean;
+    acceptedAt: number | null;
+}
+export interface CreateAccountResponse {
+    accountId: string;
+    apiKey: string;
+    environment: string;
+    message: string;
+}
+export interface ApiKeysResponse {
+    keys: Array<{
+        keyPrefix: string;
+        name: string;
+        environment: string;
+        status: string;
+        createdAt: number;
+        lastUsedAt?: number;
+    }>;
+}
+export interface CreateApiKeyResponse {
+    apiKey: string;
+    keyPrefix: string;
+    environment: string;
+    message: string;
+}
+export interface BillingStatusResponse {
+    creditBalance: number;
+    billingActivated: boolean;
+    stripeCustomerId?: string;
+    dailySpendCap: number;
+    monthlySpendCap: number;
+    autoTopup?: {
+        enabled: boolean;
+        threshold: number;
+        bundle: string;
+    };
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,159 @@
+/**
+ * HTTP client for the Virga Weather API.
+ */
+const DEFAULT_BASE_URL = "https://api.virga.dev";
+export class VirgaClient {
+    apiKey;
+    baseUrl;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    }
+    async request(method, path, options) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (options?.params) {
+            for (const [k, v] of Object.entries(options.params)) {
+                if (v !== undefined && v !== "")
+                    url.searchParams.set(k, v);
+            }
+        }
+        const res = await fetch(url.toString(), {
+            method,
+            headers: {
+                "X-API-Key": this.apiKey,
+                ...(options?.body ? { "Content-Type": "application/json" } : {}),
+            },
+            ...(options?.body ? { body: JSON.stringify(options.body) } : {}),
+        });
+        const json = (await res.json());
+        if (!res.ok) {
+            const err = json;
+            throw new VirgaApiError(err.message ?? `API error ${res.status}`, res.status, err.code ?? "UNKNOWN");
+        }
+        return json;
+    }
+    // --- Weather ---
+    async getCurrentWeather(lat, lon) {
+        return this.request("GET", "/api/v1/weather/current", {
+            params: { lat: String(lat), lon: String(lon) },
+        });
+    }
+    async getHourlyForecast(lat, lon, hours) {
+        return this.request("GET", "/api/v1/weather/forecast/hourly", {
+            params: {
+                lat: String(lat),
+                lon: String(lon),
+                ...(hours ? { hours: String(hours) } : {}),
+            },
+        });
+    }
+    async getDailyForecast(lat, lon, days) {
+        return this.request("GET", "/api/v1/weather/forecast/daily", {
+            params: {
+                lat: String(lat),
+                lon: String(lon),
+                ...(days ? { days: String(days) } : {}),
+            },
+        });
+    }
+    async getHistoricalWeather(lat, lon, date) {
+        return this.request("GET", "/api/v1/weather/historical", {
+            params: { lat: String(lat), lon: String(lon), date },
+        });
+    }
+    // --- Account ---
+    async createAccount(name) {
+        return this.requestNoAuth("POST", "/api/v1/accounts", {
+            body: { name },
+        });
+    }
+    async getAccount() {
+        return this.request("GET", "/api/v1/account");
+    }
+    async getUsage(options) {
+        const params = {};
+        if (options?.start)
+            params.start = options.start;
+        if (options?.end)
+            params.end = options.end;
+        if (options?.limit)
+            params.limit = String(options.limit);
+        return this.request("GET", "/api/v1/account/usage", {
+            params,
+        });
+    }
+    // --- Keys ---
+    async listApiKeys() {
+        return this.request("GET", "/api/v1/keys");
+    }
+    async createApiKey(name, environment) {
+        return this.request("POST", "/api/v1/keys", {
+            body: { name, ...(environment ? { environment } : {}) },
+        });
+    }
+    async revokeApiKey(keyId) {
+        return this.request("DELETE", `/api/v1/keys/${keyId}`);
+    }
+    // --- Terms ---
+    async getTerms() {
+        return this.request("GET", "/api/v1/terms");
+    }
+    async acceptTerms(version) {
+        return this.request("POST", "/api/v1/terms/accept", {
+            body: { version },
+        });
+    }
+    // --- Discovery ---
+    async getOpenApiSpec() {
+        const res = await fetch(`${this.baseUrl}/openapi.json`);
+        if (!res.ok)
+            throw new VirgaApiError(`Failed to fetch OpenAPI spec`, res.status, "FETCH_ERROR");
+        return res.text();
+    }
+    async getDocs() {
+        const res = await fetch(`${this.baseUrl}/llms.txt`);
+        if (!res.ok)
+            throw new VirgaApiError(`Failed to fetch docs`, res.status, "FETCH_ERROR");
+        return res.text();
+    }
+    // --- Billing ---
+    async activateBilling() {
+        return this.request("POST", "/api/v1/billing/activate");
+    }
+    async purchaseCredits(bundle) {
+        return this.request("POST", "/api/v1/billing/credits", {
+            body: { bundle },
+        });
+    }
+    async getBillingStatus() {
+        return this.request("GET", "/api/v1/billing/status");
+    }
+    // --- Internal helpers ---
+    async requestNoAuth(method, path, options) {
+        const url = `${this.baseUrl}${path}`;
+        const res = await fetch(url, {
+            method,
+            headers: {
+                ...(options?.body ? { "Content-Type": "application/json" } : {}),
+            },
+            ...(options?.body ? { body: JSON.stringify(options.body) } : {}),
+        });
+        const json = (await res.json());
+        if (!res.ok) {
+            const err = json;
+            throw new VirgaApiError(err.message ?? `API error ${res.status}`, res.status, err.code ?? "UNKNOWN");
+        }
+        return json;
+    }
+}
+export class VirgaApiError extends Error {
+    status;
+    code;
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = "VirgaApiError";
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Virga Weather MCP Server
+ *
+ * Exposes the Virga Weather API as MCP tools and resources for LLM clients
+ * like Claude Code, Codex, Gemini CLI, Claude Desktop, Cursor, Windsurf, OpenCode, and Xcode.
+ *
+ * Usage:
+ *   npx @virga-mcp/server --api-key sk_virga_prod_xxx
+ *   VIRGA_API_KEY=sk_virga_prod_xxx npx @virga-mcp/server
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG"}

package/dist/index.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+/**
+ * Virga Weather MCP Server
+ *
+ * Exposes the Virga Weather API as MCP tools and resources for LLM clients
+ * like Claude Code, Codex, Gemini CLI, Claude Desktop, Cursor, Windsurf, OpenCode, and Xcode.
+ *
+ * Usage:
+ *   npx @virga-mcp/server --api-key sk_virga_prod_xxx
+ *   VIRGA_API_KEY=sk_virga_prod_xxx npx @virga-mcp/server
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { VirgaClient } from "./client.js";
+import { registerTools } from "./tools.js";
+import { registerResources } from "./resources.js";
+import { registerPrompts } from "./prompts.js";
+function parseArgs(argv) {
+    const result = {};
+    for (let i = 0; i < argv.length; i++) {
+        if (argv[i] === "--api-key" && argv[i + 1]) {
+            result.apiKey = argv[++i];
+        }
+        else if (argv[i] === "--base-url" && argv[i + 1]) {
+            result.baseUrl = argv[++i];
+        }
+        else if (argv[i] === "--help" || argv[i] === "-h") {
+            printUsage();
+            process.exit(0);
+        }
+        else if (argv[i] === "--version" || argv[i] === "-v") {
+            console.error("@virga-mcp/server v0.1.0");
+            process.exit(0);
+        }
+    }
+    return result;
+}
+function printUsage() {
+    console.error(`Virga Weather MCP Server
+
+Usage:
+  virga-mcp --api-key <key>
+  VIRGA_API_KEY=<key> virga-mcp
+
+Options:
+  --api-key <key>   Virga API key (or set VIRGA_API_KEY env var)
+  --base-url <url>  API base URL (default: https://api.virga.dev)
+  --help, -h        Show this help message
+  --version, -v     Show version
+
+Quick Setup:
+
+  Claude Code:
+    claude mcp add --transport stdio --env VIRGA_API_KEY=sk_virga_prod_xxx virga-weather -- npx -y @virga-mcp/server
+
+  Codex CLI:
+    codex mcp add virga-weather --env VIRGA_API_KEY=sk_virga_prod_xxx -- npx -y @virga-mcp/server
+
+  Gemini CLI:
+    gemini mcp add virga-weather -- npx -y @virga-mcp/server --api-key sk_virga_prod_xxx
+
+  Cursor / Windsurf / Claude Desktop / OpenCode / Xcode:
+    See README for JSON configuration examples
+`);
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    const apiKey = args.apiKey ?? process.env.VIRGA_API_KEY;
+    if (!apiKey) {
+        console.error("Error: API key required. Use --api-key <key> or set VIRGA_API_KEY environment variable.");
+        console.error('Run "virga-mcp --help" for usage information.');
+        process.exit(1);
+    }
+    const client = new VirgaClient({
+        apiKey,
+        baseUrl: args.baseUrl ?? process.env.VIRGA_BASE_URL,
+    });
+    const server = new McpServer({
+        name: "virga-weather",
+        version: "0.1.0",
+    });
+    registerTools(server, client);
+    registerResources(server, client);
+    registerPrompts(server);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Virga Weather MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,MAAM,GAA0C,EAAE,CAAC;IACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,YAAY,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7B,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACpD,UAAU,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACvD,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;CAyBf,CAAC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAExD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CACX,yFAAyF,CAC1F,CAAC;QACF,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC;QAC7B,MAAM;QACN,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;KACpD,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;AAC7D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP prompt template registrations for the Virga Weather API.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiFvD"}