@cyanheads/earthquake-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/earthquake-get-feed.tool.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview Tool definition for fetching USGS pre-computed real-time earthquake feeds.
+ * @module mcp-server/tools/definitions/earthquake-get-feed.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const earthquakeGetFeed: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    magnitude_tier: z.ZodDefault<z.ZodEnum<{
+        all: "all";
+        "1.0": "1.0";
+        2.5: "2.5";
+        4.5: "4.5";
+        significant: "significant";
+    }>>;
+    time_window: z.ZodDefault<z.ZodEnum<{
+        hour: "hour";
+        day: "day";
+        week: "week";
+        month: "month";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    count: z.ZodNumber;
+    generated_at: z.ZodString;
+    events: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        magnitude: z.ZodNumber;
+        magnitude_type: z.ZodString;
+        time: z.ZodString;
+        updated: z.ZodString;
+        place: z.ZodString;
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        depth_km: z.ZodNumber;
+        felt: z.ZodNullable<z.ZodNumber>;
+        cdi: z.ZodNullable<z.ZodNumber>;
+        mmi: z.ZodNullable<z.ZodNumber>;
+        alert: z.ZodNullable<z.ZodEnum<{
+            green: "green";
+            yellow: "yellow";
+            orange: "orange";
+            red: "red";
+        }>>;
+        tsunami: z.ZodNumber;
+        significance: z.ZodNullable<z.ZodNumber>;
+        status: z.ZodEnum<{
+            automatic: "automatic";
+            reviewed: "reviewed";
+            deleted: "deleted";
+        }>;
+        event_url: z.ZodOptional<z.ZodString>;
+        detail_url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    feed_url: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "feed_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "USGS feed endpoint returns non-2xx or times out.";
+    readonly recovery: "Try a smaller time_window, or use earthquake_search as a fallback.";
+}]>;
+//# sourceMappingURL=earthquake-get-feed.tool.d.ts.map

package/dist/mcp-server/tools/definitions/earthquake-get-feed.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"earthquake-get-feed.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/earthquake-get-feed.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAIjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4F5B,CAAC"}

package/dist/mcp-server/tools/definitions/earthquake-get-feed.tool.js

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview Tool definition for fetching USGS pre-computed real-time earthquake feeds.
+ * @module mcp-server/tools/definitions/earthquake-get-feed.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { EarthquakeEventSchema, formatEvent } from '../../../mcp-server/tools/schemas.js';
+import { getUsgsService } from '../../../services/usgs/usgs-service.js';
+export const earthquakeGetFeed = tool('earthquake_get_feed', {
+    title: 'Get USGS Earthquake Feed',
+    description: 'Fetch a USGS pre-computed real-time earthquake feed by magnitude tier and time window. ' +
+        'These feeds are CDN-cached by USGS and faster and more available than the query API — ' +
+        'use them for "what\'s happening now" queries. ' +
+        '"all" includes microseisms (M<1); "significant" is a USGS curation based on magnitude, ' +
+        'felt reports, and PAGER impact estimates. ' +
+        '"hour" returns 0–10 events typically; "month" can exceed 10,000 for the "all" tier. ' +
+        'For historical or filtered queries, use earthquake_search instead.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        magnitude_tier: z
+            .enum(['all', '1.0', '2.5', '4.5', 'significant'])
+            .default('2.5')
+            .describe('Minimum magnitude threshold for the feed. ' +
+            '"all" includes microseisms (M<1). ' +
+            '"1.0" is M1.0+. "2.5" is M2.5+. "4.5" is M4.5+. ' +
+            '"significant" is a USGS curated selection based on magnitude, felt reports, and PAGER impact estimates — not purely magnitude-based.'),
+        time_window: z
+            .enum(['hour', 'day', 'week', 'month'])
+            .default('day')
+            .describe('Time window for the feed. ' +
+            '"hour" typically returns 0–10 events; "month" can exceed 10,000 for the "all" tier. ' +
+            'Prefer "hour" or "day" for real-time status checks.'),
+    }),
+    output: z.object({
+        count: z.number().describe('Number of events in the feed.'),
+        generated_at: z
+            .string()
+            .describe('ISO 8601 UTC timestamp when this feed was generated by USGS.'),
+        events: z
+            .array(EarthquakeEventSchema.describe('A single earthquake event.'))
+            .describe('Earthquake events, newest first.'),
+        feed_url: z.string().describe('Source feed URL.'),
+    }),
+    errors: [
+        {
+            reason: 'feed_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'USGS feed endpoint returns non-2xx or times out.',
+            recovery: 'Try a smaller time_window, or use earthquake_search as a fallback.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Fetching USGS feed', {
+            magnitude_tier: input.magnitude_tier,
+            time_window: input.time_window,
+        });
+        const result = await getUsgsService().getFeed(input.magnitude_tier, input.time_window, ctx);
+        ctx.log.info('Feed fetched', {
+            count: result.count,
+            magnitude_tier: input.magnitude_tier,
+            time_window: input.time_window,
+        });
+        return {
+            count: result.count,
+            generated_at: result.generatedAt,
+            events: result.events,
+            feed_url: result.feedUrl,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**Feed:** ${result.feed_url}`,
+            `**Generated:** ${result.generated_at} | **Count:** ${result.count}`,
+            '',
+        ];
+        if (result.count === 0) {
+            lines.push('_No events in this feed window._');
+        }
+        else {
+            for (const event of result.events) {
+                lines.push(...formatEvent(event));
+                lines.push('');
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=earthquake-get-feed.tool.js.map

package/dist/mcp-server/tools/definitions/earthquake-get-feed.tool.js.map

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

package/dist/mcp-server/tools/definitions/earthquake-search.tool.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @fileoverview Tool definition for searching earthquakes via USGS or EMSC FDSN query API.
+ * @module mcp-server/tools/definitions/earthquake-search.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const earthquakeSearch: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    start_time: z.ZodOptional<z.ZodString>;
+    end_time: z.ZodOptional<z.ZodString>;
+    min_magnitude: z.ZodOptional<z.ZodNumber>;
+    max_magnitude: z.ZodOptional<z.ZodNumber>;
+    latitude: z.ZodOptional<z.ZodNumber>;
+    longitude: z.ZodOptional<z.ZodNumber>;
+    radius_km: z.ZodOptional<z.ZodNumber>;
+    min_depth_km: z.ZodOptional<z.ZodNumber>;
+    max_depth_km: z.ZodOptional<z.ZodNumber>;
+    alert_level: z.ZodOptional<z.ZodEnum<{
+        green: "green";
+        yellow: "yellow";
+        orange: "orange";
+        red: "red";
+    }>>;
+    min_felt: z.ZodOptional<z.ZodNumber>;
+    min_significance: z.ZodOptional<z.ZodNumber>;
+    source: z.ZodDefault<z.ZodEnum<{
+        usgs: "usgs";
+        emsc: "emsc";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    order_by: z.ZodDefault<z.ZodEnum<{
+        magnitude: "magnitude";
+        time: "time";
+        "time-asc": "time-asc";
+        "magnitude-asc": "magnitude-asc";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    count: z.ZodNumber;
+    total_count: z.ZodOptional<z.ZodNumber>;
+    source: z.ZodEnum<{
+        usgs: "usgs";
+        emsc: "emsc";
+    }>;
+    events: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        magnitude: z.ZodNumber;
+        magnitude_type: z.ZodString;
+        time: z.ZodString;
+        updated: z.ZodString;
+        place: z.ZodString;
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        depth_km: z.ZodNumber;
+        felt: z.ZodNullable<z.ZodNumber>;
+        cdi: z.ZodNullable<z.ZodNumber>;
+        mmi: z.ZodNullable<z.ZodNumber>;
+        alert: z.ZodNullable<z.ZodEnum<{
+            green: "green";
+            yellow: "yellow";
+            orange: "orange";
+            red: "red";
+        }>>;
+        tsunami: z.ZodNumber;
+        significance: z.ZodNullable<z.ZodNumber>;
+        status: z.ZodEnum<{
+            automatic: "automatic";
+            reviewed: "reviewed";
+            deleted: "deleted";
+        }>;
+        event_url: z.ZodOptional<z.ZodString>;
+        detail_url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "query_too_broad";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "Query matches more than 20,000 events — exceeds USGS search limit.";
+    readonly recovery: string;
+}, {
+    readonly reason: "invalid_radius";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "latitude or longitude provided without radius_km, or vice versa.";
+    readonly recovery: "Provide latitude, longitude, and radius_km together for a location-based search.";
+}, {
+    readonly reason: "source_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Selected source API returns non-2xx or times out.";
+    readonly recovery: "Try the other source (usgs or emsc) or retry after a short delay.";
+}]>;
+//# sourceMappingURL=earthquake-search.tool.d.ts.map

package/dist/mcp-server/tools/definitions/earthquake-search.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"earthquake-search.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/earthquake-search.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAOjE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuO3B,CAAC"}

package/dist/mcp-server/tools/definitions/earthquake-search.tool.js

@@ -0,0 +1,199 @@
+/**
+ * @fileoverview Tool definition for searching earthquakes via USGS or EMSC FDSN query API.
+ * @module mcp-server/tools/definitions/earthquake-search.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getServerConfig } from '../../../config/server-config.js';
+import { EarthquakeEventSchema, formatEvent } from '../../../mcp-server/tools/schemas.js';
+import { getEmscService } from '../../../services/emsc/emsc-service.js';
+import { getUsgsService } from '../../../services/usgs/usgs-service.js';
+export const earthquakeSearch = tool('earthquake_search', {
+    title: 'Search Earthquakes',
+    description: 'Search earthquakes by time range, magnitude, depth, location radius, PAGER alert level, or felt reports. ' +
+        'Supports USGS (global, richer metadata: PAGER, DYFI, ShakeMap) and EMSC (European-Mediterranean, independent catalog). ' +
+        'For location-based queries, provide latitude, longitude, and radius_km together. ' +
+        'USGS-specific filters (alert_level, min_felt, min_significance) are ignored when source=emsc. ' +
+        'Use earthquake_count first to gauge result size before requesting large result sets. ' +
+        'Results are capped at 20,000 events per query.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        start_time: z
+            .string()
+            .optional()
+            .describe('Start of time range as ISO 8601 (e.g. "2026-01-01" or "2026-05-23T00:00:00"). ' +
+            'Defaults to 30 days before end_time if omitted.'),
+        end_time: z
+            .string()
+            .optional()
+            .describe('End of time range as ISO 8601. Defaults to current time if omitted.'),
+        min_magnitude: z
+            .number()
+            .min(-1)
+            .max(10)
+            .optional()
+            .describe('Minimum magnitude (Richter or equivalent). ' +
+            'M2.5+ is felt by some people; M5+ can cause damage; M7+ is major.'),
+        max_magnitude: z.number().min(-1).max(10).optional().describe('Maximum magnitude.'),
+        latitude: z
+            .number()
+            .min(-90)
+            .max(90)
+            .optional()
+            .describe('Latitude for radius search. Requires longitude and radius_km.'),
+        longitude: z
+            .number()
+            .min(-180)
+            .max(180)
+            .optional()
+            .describe('Longitude for radius search. Requires latitude and radius_km.'),
+        radius_km: z
+            .number()
+            .min(0)
+            .max(20002)
+            .optional()
+            .describe('Search radius in kilometers from the lat/lon point. ' +
+            '100 km covers a metro region; 500 km covers a large country. ' +
+            'Converted to degrees for EMSC (1° ≈ 111.2 km).'),
+        min_depth_km: z
+            .number()
+            .optional()
+            .describe('Minimum depth in kilometers. ' +
+            'Shallow quakes (0–70 km) typically cause more surface damage than deep quakes (>300 km).'),
+        max_depth_km: z.number().optional().describe('Maximum depth in kilometers.'),
+        alert_level: z
+            .enum(['green', 'yellow', 'orange', 'red'])
+            .optional()
+            .describe('Minimum PAGER alert level. PAGER estimates economic loss and casualties. ' +
+            '"green" = minimal impact; "red" = extreme. Only available from USGS.'),
+        min_felt: z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .describe('Minimum number of DYFI (Did You Feel It?) reports. ' +
+            'Use to find events with confirmed public impact. Only available from USGS.'),
+        min_significance: z
+            .number()
+            .int()
+            .optional()
+            .describe('Minimum USGS significance score (0–2000+). ' +
+            'Combines magnitude, felt reports, and PAGER estimates. ' +
+            'Significant events typically score 600+. Only available from USGS.'),
+        source: z
+            .enum(['usgs', 'emsc'])
+            .default('usgs')
+            .describe('Data source. ' +
+            '"usgs" covers global events with PAGER, DYFI, and ShakeMap metadata. ' +
+            '"emsc" covers the European-Mediterranean region with an independent catalog — ' +
+            'useful for cross-verification or European-focused queries.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(20000)
+            .optional()
+            .describe('Maximum events to return. Default 100. ' +
+            'Large limits (>1000) may result in slow responses. Max 20000.'),
+        order_by: z
+            .enum(['time', 'time-asc', 'magnitude', 'magnitude-asc'])
+            .default('time')
+            .describe('Sort order. "time" returns newest first; "magnitude" returns largest first.'),
+    }),
+    output: z.object({
+        count: z.number().describe('Number of events returned.'),
+        total_count: z
+            .number()
+            .optional()
+            .describe('Total events matching the query before the limit was applied. ' +
+            'Absent when all results fit in the response.'),
+        source: z.enum(['usgs', 'emsc']).describe('Data source used.'),
+        events: z
+            .array(EarthquakeEventSchema.describe('A single earthquake event.'))
+            .describe('Matching earthquake events.'),
+    }),
+    errors: [
+        {
+            reason: 'query_too_broad',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'Query matches more than 20,000 events — exceeds USGS search limit.',
+            recovery: 'Narrow the time range, raise min_magnitude, or add a location radius filter. ' +
+                'Use earthquake_count first to gauge result size.',
+        },
+        {
+            reason: 'invalid_radius',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'latitude or longitude provided without radius_km, or vice versa.',
+            recovery: 'Provide latitude, longitude, and radius_km together for a location-based search.',
+        },
+        {
+            reason: 'source_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'Selected source API returns non-2xx or times out.',
+            recovery: 'Try the other source (usgs or emsc) or retry after a short delay.',
+        },
+    ],
+    async handler(input, ctx) {
+        // Validate radius params — all three must be provided together
+        const latProvided = input.latitude != null;
+        const lonProvided = input.longitude != null;
+        const radiusProvided = input.radius_km != null;
+        if ((latProvided || lonProvided || radiusProvided) &&
+            !(latProvided && lonProvided && radiusProvided)) {
+            throw ctx.fail('invalid_radius', 'Radius search requires latitude, longitude, and radius_km — provide all three together.', { ...ctx.recoveryFor('invalid_radius') });
+        }
+        const config = getServerConfig();
+        const limit = input.limit ?? config.defaultLimit;
+        ctx.log.info('Searching earthquakes', {
+            source: input.source,
+            limit,
+            start_time: input.start_time,
+            min_magnitude: input.min_magnitude,
+        });
+        // Use conditional spreads to satisfy exactOptionalPropertyTypes
+        const params = {
+            limit,
+            orderBy: input.order_by,
+            ...(input.start_time != null ? { startTime: input.start_time } : {}),
+            ...(input.end_time != null ? { endTime: input.end_time } : {}),
+            ...(input.min_magnitude != null ? { minMagnitude: input.min_magnitude } : {}),
+            ...(input.max_magnitude != null ? { maxMagnitude: input.max_magnitude } : {}),
+            ...(input.latitude != null ? { latitude: input.latitude } : {}),
+            ...(input.longitude != null ? { longitude: input.longitude } : {}),
+            ...(input.radius_km != null ? { radiusKm: input.radius_km } : {}),
+            ...(input.min_depth_km != null ? { minDepthKm: input.min_depth_km } : {}),
+            ...(input.max_depth_km != null ? { maxDepthKm: input.max_depth_km } : {}),
+            ...(input.alert_level != null ? { alertLevel: input.alert_level } : {}),
+            ...(input.min_felt != null ? { minFelt: input.min_felt } : {}),
+            ...(input.min_significance != null ? { minSignificance: input.min_significance } : {}),
+        };
+        const result = input.source === 'emsc'
+            ? await getEmscService().searchEvents(params, ctx)
+            : await getUsgsService().searchEvents(params, ctx);
+        ctx.log.info('Search completed', { source: input.source, count: result.count });
+        return {
+            count: result.count,
+            ...(result.totalCount != null ? { total_count: result.totalCount } : {}),
+            source: input.source,
+            events: result.events,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**Source:** ${result.source.toUpperCase()} | **Count:** ${result.count}${result.total_count != null ? ` of ${result.total_count} total` : ''}`,
+            '',
+        ];
+        if (result.count === 0) {
+            lines.push('_No events matched the query. ' +
+                'Try broadening the time range, lowering min_magnitude, or expanding the radius._');
+        }
+        else {
+            for (const event of result.events) {
+                lines.push(...formatEvent(event));
+                lines.push('');
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=earthquake-search.tool.js.map

package/dist/mcp-server/tools/definitions/earthquake-search.tool.js.map

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

package/dist/mcp-server/tools/schemas.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview Shared Zod schemas for earthquake event output fields used across tool definitions.
+ * @module mcp-server/tools/schemas
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+/** Zod schema for a normalized earthquake event returned by feeds and search results. */
+export declare const EarthquakeEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    magnitude: z.ZodNumber;
+    magnitude_type: z.ZodString;
+    time: z.ZodString;
+    updated: z.ZodString;
+    place: z.ZodString;
+    latitude: z.ZodNumber;
+    longitude: z.ZodNumber;
+    depth_km: z.ZodNumber;
+    felt: z.ZodNullable<z.ZodNumber>;
+    cdi: z.ZodNullable<z.ZodNumber>;
+    mmi: z.ZodNullable<z.ZodNumber>;
+    alert: z.ZodNullable<z.ZodEnum<{
+        green: "green";
+        yellow: "yellow";
+        orange: "orange";
+        red: "red";
+    }>>;
+    tsunami: z.ZodNumber;
+    significance: z.ZodNullable<z.ZodNumber>;
+    status: z.ZodEnum<{
+        automatic: "automatic";
+        reviewed: "reviewed";
+        deleted: "deleted";
+    }>;
+    event_url: z.ZodOptional<z.ZodString>;
+    detail_url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type EarthquakeEventOutput = {
+    id: string;
+    title: string;
+    magnitude: number;
+    magnitude_type: string;
+    time: string;
+    updated: string;
+    place: string;
+    latitude: number;
+    longitude: number;
+    depth_km: number;
+    felt: number | null;
+    cdi: number | null;
+    mmi: number | null;
+    alert: 'green' | 'yellow' | 'orange' | 'red' | null;
+    tsunami: number;
+    significance: number | null;
+    status: 'automatic' | 'reviewed' | 'deleted';
+    event_url?: string | undefined;
+    detail_url?: string | undefined;
+};
+/** Format a single earthquake event as markdown lines. Renders all schema fields for format-parity. */
+export declare function formatEvent(event: EarthquakeEventOutput): string[];
+//# sourceMappingURL=schemas.d.ts.map

package/dist/mcp-server/tools/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAE3C,yFAAyF;AACzF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoDhC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,IAAI,CAAC;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;IAE7C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAgClE"}

package/dist/mcp-server/tools/schemas.js

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview Shared Zod schemas for earthquake event output fields used across tool definitions.
+ * @module mcp-server/tools/schemas
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+/** Zod schema for a normalized earthquake event returned by feeds and search results. */
+export const EarthquakeEventSchema = z.object({
+    id: z.string().describe('USGS or EMSC event identifier.'),
+    title: z
+        .string()
+        .describe('Human-readable event summary, e.g. "M 6.0 - 13 km S of Honaunau-Napoopoo, Hawaii".'),
+    magnitude: z.number().describe('Preferred magnitude value.'),
+    magnitude_type: z.string().describe('Magnitude type (ml, mww, mw, mb, etc.).'),
+    time: z.string().describe('ISO 8601 UTC origin time.'),
+    updated: z.string().describe('ISO 8601 UTC time this record was last updated.'),
+    place: z.string().describe('Nearest named location.'),
+    latitude: z.number().describe('Epicenter latitude in decimal degrees.'),
+    longitude: z.number().describe('Epicenter longitude in decimal degrees.'),
+    depth_km: z
+        .number()
+        .describe('Hypocenter depth in kilometers. Shallow (<70 km), intermediate (70–300 km), or deep (>300 km).'),
+    felt: z
+        .number()
+        .nullable()
+        .describe('Number of DYFI (Did You Feel It?) responses. Null if no reports. USGS only.'),
+    cdi: z
+        .number()
+        .nullable()
+        .describe('Maximum reported intensity (Community Decimal Intensity, 0–12 scale). USGS only.'),
+    mmi: z
+        .number()
+        .nullable()
+        .describe('Maximum ShakeMap instrumental intensity (Modified Mercalli, 0–12 scale). USGS only.'),
+    alert: z
+        .enum(['green', 'yellow', 'orange', 'red'])
+        .nullable()
+        .describe('PAGER estimated impact alert level. Null if not computed. USGS only.'),
+    tsunami: z
+        .number()
+        .describe('1 if a tsunami warning was issued; 0 otherwise. USGS only; 0 for EMSC events.'),
+    significance: z
+        .number()
+        .nullable()
+        .describe('USGS significance score (0–2000+). Combines magnitude, felt reports, PAGER. USGS only.'),
+    status: z
+        .enum(['automatic', 'reviewed', 'deleted'])
+        .describe('Review status. Automatic detections may be revised.'),
+    event_url: z.string().optional().describe('USGS event page URL. Present for USGS events only.'),
+    detail_url: z
+        .string()
+        .optional()
+        .describe('URL to fetch the full GeoJSON detail record. Present in USGS list responses.'),
+});
+/** Format a single earthquake event as markdown lines. Renders all schema fields for format-parity. */
+export function formatEvent(event) {
+    const lines = [];
+    lines.push(`## ${event.title}`);
+    lines.push(`**ID:** ${event.id} | **Magnitude:** ${event.magnitude} (${event.magnitude_type}) | **Depth:** ${event.depth_km} km`);
+    lines.push(`**Place:** ${event.place}`);
+    lines.push(`**Time:** ${event.time} | **Updated:** ${event.updated} | **Status:** ${event.status}`);
+    lines.push(`**Location:** ${event.latitude.toFixed(4)}°, ${event.longitude.toFixed(4)}°`);
+    // Impact fields (USGS-specific; render explicitly for format-parity compliance)
+    lines.push(`**PAGER Alert:** ${event.alert !== null ? event.alert.toUpperCase() : 'Not computed'}`);
+    // Render tsunami as its raw value so the linter's format-parity sentinel check passes
+    lines.push(`**Tsunami (warning flag):** ${event.tsunami}${event.tsunami !== 0 ? ' ⚠️ Warning issued' : ''}`);
+    const impactParts = [];
+    if (event.felt !== null)
+        impactParts.push(`Felt by ${event.felt} (DYFI)`);
+    if (event.mmi !== null)
+        impactParts.push(`ShakeMap MMI: ${event.mmi}`);
+    if (event.cdi !== null)
+        impactParts.push(`CDI: ${event.cdi}`);
+    if (event.significance !== null)
+        impactParts.push(`Significance: ${event.significance}`);
+    if (impactParts.length > 0)
+        lines.push(`**Impact:** ${impactParts.join(' | ')}`);
+    if (event.event_url)
+        lines.push(`**USGS page:** ${event.event_url}`);
+    if (event.detail_url)
+        lines.push(`**Detail URL:** ${event.detail_url}`);
+    return lines;
+}
+//# sourceMappingURL=schemas.js.map

package/dist/mcp-server/tools/schemas.js.map

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

package/dist/services/emsc/emsc-service.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview EMSC (European-Mediterranean Seismological Centre) FDSN event API client.
+ * @module services/emsc/emsc-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { AppConfig } from '@cyanheads/mcp-ts-core/config';
+import type { StorageService } from '@cyanheads/mcp-ts-core/storage';
+import type { EarthquakeEvent, EarthquakeQueryParams } from '../usgs/types.js';
+export declare class EmscService {
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    constructor(_config: AppConfig, _storage: StorageService, emscBaseUrl: string, timeoutMs: number);
+    /** Query EMSC FDSN event API. */
+    searchEvents(params: EarthquakeQueryParams, ctx: Context): Promise<{
+        events: EarthquakeEvent[];
+        count: number;
+        totalCount?: number;
+    }>;
+    /** Count events matching a query. */
+    countEvents(params: EarthquakeQueryParams, ctx: Context): Promise<{
+        count: number;
+        maxAllowed: number | null;
+        exceedsLimit: boolean;
+    }>;
+    /** Build FDSN query string from params, converting km radius to degrees for EMSC. */
+    private buildFdsnQuery;
+}
+export declare function initEmscService(config: AppConfig, storage: StorageService, emscBaseUrl: string, timeoutMs: number): void;
+export declare function getEmscService(): EmscService;
+//# sourceMappingURL=emsc-service.d.ts.map