@cyanheads/earthquake-mcp-server 0.1.1

package/dist/config/server-config.js

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Server-specific environment variable configuration for earthquake-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+const ServerConfigSchema = z.object({
+    usgsBaseUrl: z
+        .string()
+        .url()
+        .default('https://earthquake.usgs.gov')
+        .describe('USGS API base URL. Override for testing or mirroring.'),
+    emscBaseUrl: z
+        .string()
+        .url()
+        .default('https://www.seismicportal.eu')
+        .describe('EMSC API base URL. Override for testing or mirroring.'),
+    defaultLimit: z.coerce
+        .number()
+        .int()
+        .min(1)
+        .max(20000)
+        .default(100)
+        .describe('Default result limit for earthquake_search.'),
+    requestTimeoutMs: z.coerce
+        .number()
+        .int()
+        .min(1000)
+        .max(120000)
+        .default(10000)
+        .describe('HTTP timeout in milliseconds.'),
+});
+let _config;
+export function getServerConfig() {
+    _config ??= parseEnvConfig(ServerConfigSchema, {
+        usgsBaseUrl: 'USGS_BASE_URL',
+        emscBaseUrl: 'EMSC_BASE_URL',
+        defaultLimit: 'DEFAULT_LIMIT',
+        requestTimeoutMs: 'REQUEST_TIMEOUT_MS',
+    });
+    return _config;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,6BAA6B,CAAC;SACtC,QAAQ,CAAC,uDAAuD,CAAC;IACpE,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,8BAA8B,CAAC;SACvC,QAAQ,CAAC,uDAAuD,CAAC;IACpE,YAAY,EAAE,CAAC,CAAC,MAAM;SACnB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,KAAK,CAAC;SACV,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CAAC,6CAA6C,CAAC;IAC1D,gBAAgB,EAAE,CAAC,CAAC,MAAM;SACvB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,IAAI,CAAC;SACT,GAAG,CAAC,MAAM,CAAC;SACX,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,+BAA+B,CAAC;CAC7C,CAAC,CAAC;AAEH,IAAI,OAAuD,CAAC;AAE5D,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,WAAW,EAAE,eAAe;QAC5B,WAAW,EAAE,eAAe;QAC5B,YAAY,EAAE,eAAe;QAC7B,gBAAgB,EAAE,oBAAoB;KACvC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview earthquake-mcp-server MCP server entry point.
+ * @module index
+ */
+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":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview earthquake-mcp-server MCP server entry point.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { getServerConfig } from './config/server-config.js';
+import { earthquakeEventResource } from './mcp-server/resources/definitions/earthquake-event.resource.js';
+import { earthquakeFeedResource } from './mcp-server/resources/definitions/earthquake-feed.resource.js';
+import { earthquakeCount } from './mcp-server/tools/definitions/earthquake-count.tool.js';
+import { earthquakeGetEvent } from './mcp-server/tools/definitions/earthquake-get-event.tool.js';
+import { earthquakeGetFeed } from './mcp-server/tools/definitions/earthquake-get-feed.tool.js';
+import { earthquakeSearch } from './mcp-server/tools/definitions/earthquake-search.tool.js';
+import { initEmscService } from './services/emsc/emsc-service.js';
+import { initUsgsService } from './services/usgs/usgs-service.js';
+await createApp({
+    tools: [earthquakeGetFeed, earthquakeSearch, earthquakeGetEvent, earthquakeCount],
+    resources: [earthquakeFeedResource, earthquakeEventResource],
+    prompts: [],
+    setup(core) {
+        const config = getServerConfig();
+        initUsgsService(core.config, core.storage, config.usgsBaseUrl, config.requestTimeoutMs);
+        initEmscService(core.config, core.storage, config.emscBaseUrl, config.requestTimeoutMs);
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,EAAE,sBAAsB,EAAE,MAAM,gEAAgE,CAAC;AACxG,OAAO,EAAE,eAAe,EAAE,MAAM,yDAAyD,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,6DAA6D,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,4DAA4D,CAAC;AAC/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,0DAA0D,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,MAAM,SAAS,CAAC;IACd,KAAK,EAAE,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,CAAC;IACjF,SAAS,EAAE,CAAC,sBAAsB,EAAE,uBAAuB,CAAC;IAC5D,OAAO,EAAE,EAAE;IACX,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACxF,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC1F,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/earthquake-event.resource.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Resource definition for accessing full USGS earthquake event detail by ID via URI.
+ * @module mcp-server/resources/definitions/earthquake-event.resource
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const earthquakeEventResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    event_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event: 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>, undefined>;
+//# sourceMappingURL=earthquake-event.resource.d.ts.map

package/dist/mcp-server/resources/definitions/earthquake-event.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"earthquake-event.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/earthquake-event.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAIrD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAsBlC,CAAC"}

package/dist/mcp-server/resources/definitions/earthquake-event.resource.js

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Resource definition for accessing full USGS earthquake event detail by ID via URI.
+ * @module mcp-server/resources/definitions/earthquake-event.resource
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { EarthquakeEventSchema } from '../../../mcp-server/tools/schemas.js';
+import { getUsgsService } from '../../../services/usgs/usgs-service.js';
+export const earthquakeEventResource = resource('earthquake://event/{event_id}', {
+    name: 'earthquake-event',
+    title: 'USGS Earthquake Event',
+    description: 'Full earthquake event detail by USGS event ID as injectable context. ' +
+        'Returns the complete property set including felt reports, ShakeMap intensity, PAGER alert, and products metadata. ' +
+        'Use event IDs from earthquake_get_feed or earthquake_search results.',
+    mimeType: 'application/json',
+    params: z.object({
+        event_id: z.string().describe('USGS event ID, e.g. "us6000sznj" or "hv74966427".'),
+    }),
+    output: z.object({
+        event: EarthquakeEventSchema.describe('Full earthquake event detail.'),
+    }),
+    async handler(params, ctx) {
+        ctx.log.debug('Fetching event resource', { event_id: params.event_id });
+        const event = await getUsgsService().getEvent(params.event_id, ctx);
+        return { event };
+    },
+});
+//# sourceMappingURL=earthquake-event.resource.js.map

package/dist/mcp-server/resources/definitions/earthquake-event.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"earthquake-event.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/earthquake-event.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,MAAM,CAAC,MAAM,uBAAuB,GAAG,QAAQ,CAAC,+BAA+B,EAAE;IAC/E,IAAI,EAAE,kBAAkB;IACxB,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EACT,uEAAuE;QACvE,oHAAoH;QACpH,sEAAsE;IACxE,QAAQ,EAAE,kBAAkB;IAE5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;KACnF,CAAC;IAEF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,qBAAqB,CAAC,QAAQ,CAAC,+BAA+B,CAAC;KACvE,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACpE,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/earthquake-feed.resource.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Resource definition for direct access to USGS real-time earthquake feeds by URI.
+ * @module mcp-server/resources/definitions/earthquake-feed.resource
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const earthquakeFeedResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    magnitude_tier: z.ZodString;
+    time_window: z.ZodString;
+}, 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;
+        time: z.ZodString;
+        place: z.ZodString;
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        depth_km: z.ZodNumber;
+    }, z.core.$strip>>;
+    feed_url: z.ZodString;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=earthquake-feed.resource.d.ts.map

package/dist/mcp-server/resources/definitions/earthquake-feed.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"earthquake-feed.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/earthquake-feed.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAOrD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;6BAoFjC,CAAC"}

package/dist/mcp-server/resources/definitions/earthquake-feed.resource.js

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview Resource definition for direct access to USGS real-time earthquake feeds by URI.
+ * @module mcp-server/resources/definitions/earthquake-feed.resource
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { getUsgsService } from '../../../services/usgs/usgs-service.js';
+const VALID_TIERS = ['all', '1.0', '2.5', '4.5', 'significant'];
+const VALID_WINDOWS = ['hour', 'day', 'week', 'month'];
+export const earthquakeFeedResource = resource('earthquake://feed/{magnitude_tier}/{time_window}', {
+    name: 'earthquake-feed',
+    title: 'USGS Earthquake Feed',
+    description: 'Direct access to a USGS real-time earthquake feed as injectable context. ' +
+        'magnitude_tier: all | 1.0 | 2.5 | 4.5 | significant. ' +
+        'time_window: hour | day | week | month.',
+    mimeType: 'application/json',
+    params: z.object({
+        magnitude_tier: z.string().describe('Magnitude tier: all, 1.0, 2.5, 4.5, or significant.'),
+        time_window: z.string().describe('Time window: hour, day, week, or month.'),
+    }),
+    output: z.object({
+        count: z.number().describe('Number of events in the feed.'),
+        generated_at: z.string().describe('ISO 8601 UTC timestamp when USGS generated this feed.'),
+        events: z
+            .array(z
+            .object({
+            id: z.string().describe('USGS event identifier.'),
+            title: z.string().describe('Human-readable event summary.'),
+            magnitude: z.number().describe('Preferred magnitude value.'),
+            time: z.string().describe('ISO 8601 UTC origin time.'),
+            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.'),
+        })
+            .describe('A single earthquake event.'))
+            .describe('Earthquake events, newest first.'),
+        feed_url: z.string().describe('Source feed URL.'),
+    }),
+    async handler(params, ctx) {
+        if (!VALID_TIERS.includes(params.magnitude_tier)) {
+            throw notFound(`Unknown magnitude tier "${params.magnitude_tier}". Valid tiers: ${VALID_TIERS.join(', ')}.`, { magnitude_tier: params.magnitude_tier });
+        }
+        if (!VALID_WINDOWS.includes(params.time_window)) {
+            throw notFound(`Unknown time window "${params.time_window}". Valid windows: ${VALID_WINDOWS.join(', ')}.`, { time_window: params.time_window });
+        }
+        const tier = params.magnitude_tier;
+        const window = params.time_window;
+        ctx.log.debug('Fetching feed resource', { tier, window });
+        const result = await getUsgsService().getFeed(tier, window, ctx);
+        return {
+            count: result.count,
+            generated_at: result.generatedAt,
+            events: result.events.map((e) => ({
+                id: e.id,
+                title: e.title,
+                magnitude: e.magnitude,
+                time: e.time,
+                place: e.place,
+                latitude: e.latitude,
+                longitude: e.longitude,
+                depth_km: e.depth_km,
+            })),
+            feed_url: result.feedUrl,
+        };
+    },
+    list: () => ({
+        resources: VALID_TIERS.flatMap((tier) => VALID_WINDOWS.map((window) => ({
+            uri: `earthquake://feed/${tier}/${window}`,
+            name: `USGS ${tier} earthquakes (${window})`,
+            description: `USGS real-time feed: M${tier}+ events in the last ${window}.`,
+            mimeType: 'application/json',
+        }))),
+    }),
+});
+//# sourceMappingURL=earthquake-feed.resource.js.map

package/dist/mcp-server/resources/definitions/earthquake-feed.resource.js.map

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

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

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Tool definition for counting earthquakes matching filters without fetching full records.
+ * @module mcp-server/tools/definitions/earthquake-count.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const earthquakeCount: 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";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    count: z.ZodNumber;
+    max_allowed: z.ZodNullable<z.ZodNumber>;
+    source: z.ZodEnum<{
+        usgs: "usgs";
+        emsc: "emsc";
+    }>;
+    exceeds_limit: z.ZodBoolean;
+}, z.core.$strip>, readonly [{
+    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 count.";
+}, {
+    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-count.tool.d.ts.map

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

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

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

@@ -0,0 +1,170 @@
+/**
+ * @fileoverview Tool definition for counting earthquakes matching filters without fetching full records.
+ * @module mcp-server/tools/definitions/earthquake-count.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getEmscService } from '../../../services/emsc/emsc-service.js';
+import { getUsgsService } from '../../../services/usgs/usgs-service.js';
+export const earthquakeCount = tool('earthquake_count', {
+    title: 'Count Earthquakes',
+    description: 'Count earthquakes matching filters without fetching full records. ' +
+        'Use for statistical queries ("how many M5+ earthquakes in 2025?") or to gauge result size ' +
+        'before calling earthquake_search. ' +
+        'When exceeds_limit is true, the count exceeds 20,000 and a full search would be truncated — ' +
+        'narrow filters before fetching. ' +
+        'USGS returns the max_allowed cap (20,000); EMSC count endpoint does not return this field ' +
+        '(max_allowed will be null). ' +
+        'USGS-specific filters (alert_level, min_felt, min_significance) are ignored when source=emsc.',
+    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. ' +
+            '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 count 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.'),
+    }),
+    output: z.object({
+        count: z.number().describe('Number of events matching the query.'),
+        max_allowed: z
+            .number()
+            .nullable()
+            .describe('Maximum events the API would return for a full fetch. 20000 for USGS. ' +
+            'Null for EMSC — the EMSC count endpoint does not return this field.'),
+        source: z.enum(['usgs', 'emsc']).describe('Data source used.'),
+        exceeds_limit: z
+            .boolean()
+            .describe('True when count exceeds 20000 — a full earthquake_search would be truncated. ' +
+            'For EMSC, evaluated against the known 20000 limit since max_allowed is not returned. ' +
+            'Narrow filters to retrieve all matching events.'),
+    }),
+    errors: [
+        {
+            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 count.',
+        },
+        {
+            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) {
+        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') });
+        }
+        ctx.log.info('Counting earthquakes', {
+            source: input.source,
+            start_time: input.start_time,
+            min_magnitude: input.min_magnitude,
+        });
+        // Use conditional spreads to satisfy exactOptionalPropertyTypes
+        const params = {
+            ...(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().countEvents(params, ctx)
+            : await getUsgsService().countEvents(params, ctx);
+        ctx.log.info('Count completed', {
+            source: input.source,
+            count: result.count,
+            exceeds_limit: result.exceedsLimit,
+        });
+        return {
+            count: result.count,
+            max_allowed: result.maxAllowed,
+            source: input.source,
+            exceeds_limit: result.exceedsLimit,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**Source:** ${result.source.toUpperCase()}`,
+            `**Count:** ${result.count}`,
+            `**Max allowed:** ${result.max_allowed ?? 'Not reported by EMSC'}`,
+            `**Exceeds limit:** ${result.exceeds_limit ? '⚠️ Yes — full search would be truncated. Narrow filters.' : 'No'}`,
+        ];
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=earthquake-count.tool.js.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Tool definition for fetching full detail for a specific USGS earthquake event.
+ * @module mcp-server/tools/definitions/earthquake-get-event.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const earthquakeGetEvent: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    event_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event: 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: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No event matches the provided event_id.";
+    readonly recovery: string;
+}]>;
+//# sourceMappingURL=earthquake-get-event.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"earthquake-get-event.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/earthquake-get-event.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,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoD7B,CAAC"}

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

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview Tool definition for fetching full detail for a specific USGS earthquake event.
+ * @module mcp-server/tools/definitions/earthquake-get-event.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 earthquakeGetEvent = tool('earthquake_get_event', {
+    title: 'Get Earthquake Event Detail',
+    description: 'Fetch complete detail for a specific earthquake by USGS event ID. ' +
+        'Returns the full property set including felt reports count (DYFI), ShakeMap maximum intensity (MMI), ' +
+        'PAGER alert level, tsunami flag, and magnitude type. ' +
+        'Event IDs appear in the "id" field of earthquake_get_feed and earthquake_search results. ' +
+        'This tool is USGS-only — EMSC events have no per-event detail endpoint.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        event_id: z
+            .string()
+            .describe('USGS event ID, e.g. "hv74966427" or "us6000sznj". ' +
+            'Found in the "id" field of earthquake_get_feed and earthquake_search results.'),
+    }),
+    output: z.object({
+        event: EarthquakeEventSchema.describe('Full earthquake event detail.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No event matches the provided event_id.',
+            recovery: 'Verify the event ID from a feed or search result. ' +
+                'IDs are network-specific strings like "us6000sznj" or "hv74966427".',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Fetching earthquake event detail', { event_id: input.event_id });
+        const event = await getUsgsService().getEvent(input.event_id, ctx);
+        ctx.log.info('Event fetched', {
+            event_id: input.event_id,
+            magnitude: event.magnitude,
+            place: event.place,
+        });
+        return { event };
+    },
+    format: (result) => {
+        const lines = formatEvent(result.event);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=earthquake-get-event.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"earthquake-get-event.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/earthquake-get-event.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,sBAAsB,EAAE;IAC7D,KAAK,EAAE,6BAA6B;IACpC,WAAW,EACT,oEAAoE;QACpE,uGAAuG;QACvG,uDAAuD;QACvD,2FAA2F;QAC3F,yEAAyE;IAC3E,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAE9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,CACP,oDAAoD;YAClD,+EAA+E,CAClF;KACJ,CAAC;IAEF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,qBAAqB,CAAC,QAAQ,CAAC,+BAA+B,CAAC;KACvE,CAAC;IAEF,MAAM,EAAE;QACN;YACE,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,yCAAyC;YAC/C,QAAQ,EACN,oDAAoD;gBACpD,qEAAqE;SACxE;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE/E,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAEnE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE;YAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;QAEH,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}