{"name":"io.github.cyanheads/earthquake-mcp-server","slug":"cyanheads-earthquake-mcp-server","title":null,"description":"Search USGS and EMSC seismic data — real-time feeds, event queries, and earthquake counts.","url":"https://mcp.market/server/cyanheads-earthquake-mcp-server","rating":null,"grade":"A","score":93,"certified":false,"status":"active","category":"search","tags":["search"],"presence":{"score":37,"stars":1,"forks":0,"downloads_week":576,"last_push_at":"2026-09-19T18:53:05.000Z","license":"Apache-2.0"},"uptime":{"percent":100,"checks":9,"ok":9,"last_checked_at":"2026-09-21T15:30:35.600Z","last_ok_at":"2026-09-21T15:30:35.600Z","latency_ms":312},"claimed":false,"transport":"mixed","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/cyanheads/earthquake-mcp-server","website":null,"version":"0.3.6","remotes":[{"type":"streamable-http","url":"https://earthquake.caseyjhand.com/mcp"}],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"@cyanheads/earthquake-mcp-server","version":"0.3.6","runtimeHint":"bun","transport":{"type":"stdio"},"packageArguments":[{"value":"run","type":"positional"},{"value":"start:stdio","type":"positional"}],"environmentVariables":[{"description":"Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').","format":"string","default":"info","name":"MCP_LOG_LEVEL"}]},{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"@cyanheads/earthquake-mcp-server","version":"0.3.6","runtimeHint":"bun","transport":{"type":"streamable-http","url":"http://localhost:3010/mcp"},"packageArguments":[{"value":"run","type":"positional"},{"value":"start:http","type":"positional"}],"environmentVariables":[{"description":"The hostname for the HTTP server.","format":"string","default":"127.0.0.1","name":"MCP_HTTP_HOST"},{"description":"The port to run the HTTP server on.","format":"string","default":"3010","name":"MCP_HTTP_PORT"},{"description":"The endpoint path for the MCP server.","format":"string","default":"/mcp","name":"MCP_HTTP_ENDPOINT_PATH"},{"description":"Authentication mode to use: 'none', 'jwt', or 'oauth'.","format":"string","default":"none","name":"MCP_AUTH_MODE"},{"description":"Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').","format":"string","default":"info","name":"MCP_LOG_LEVEL"}]}],"tools":[{"name":"earthquake_count","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. Omitting start_time counts only the last 30 days, so pass an explicit range for any period-specific question; queryEcho reports the window and filters the count actually covers. 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). Counts can be scoped to a rectangular study area with min_latitude, max_latitude, min_longitude, and max_longitude — each independently optional. Combining the box with the lat/lon/radius circle intersects the two, counting only events inside both. Both catalogs include non-tectonic records, so a radius over a mining region counts quarry blasts alongside earthquakes — pass event_type=\"earthquake\" on USGS to exclude them. USGS-specific filters (alert_level, event_type, min_felt, min_significance) are not sent when source=emsc — the response names them in ignoredFilters.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"start_time":{"description":"Start of time range as ISO 8601 (e.g. \"2026-01-01\" or \"2026-05-23T00:00:00\"). A bare year expands to January 1st and an unpadded month or day is zero-padded, so both sources honor the same window. Defaults to 30 days before end_time (or before the current time) if omitted — applied server-side so USGS and EMSC honor the same window.","type":"string","pattern":"^\\d{4}(-\\d{1,2}(-\\d{1,2})?)?([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$"},"end_time":{"description":"End of time range as ISO 8601, in the same forms start_time accepts. Defaults to current time if omitted.","type":"string","pattern":"^\\d{4}(-\\d{1,2}(-\\d{1,2})?)?([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$"},"min_magnitude":{"description":"Minimum magnitude (Richter or equivalent). M2.5+ is felt by some people; M5+ can cause damage; M7+ is major.","type":"number","minimum":-1,"maximum":10},"max_magnitude":{"description":"Maximum magnitude.","type":"number","minimum":-1,"maximum":10},"latitude":{"description":"Latitude for radius search. Requires longitude and radius_km.","type":"number","minimum":-90,"maximum":90},"longitude":{"description":"Longitude for radius search. Requires latitude and radius_km.","type":"number","minimum":-180,"maximum":180},"radius_km":{"description":"Search radius in kilometers from the lat/lon point. Max 20001.6, the ceiling USGS enforces — half the Earth's great-circle circumference. Converted to degrees for EMSC (1° ≈ 111.2 km).","type":"number","minimum":0,"maximum":20001.6},"min_latitude":{"description":"Southern edge of a bounding-box search, in degrees. Independent of the other three box parameters — supply any of them. Must not exceed max_latitude when both are given.","type":"number","minimum":-90,"maximum":90},"max_latitude":{"description":"Northern edge of a bounding-box search, in degrees.","type":"number","minimum":-90,"maximum":90},"min_longitude":{"description":"Western edge of a bounding-box search, in degrees. Range extends beyond ±180 so a box can cross the antimeridian (e.g. min_longitude=170, max_longitude=190) — always keep min_longitude at or below max_longitude rather than inverting the pair.","type":"number","minimum":-360,"maximum":360},"max_longitude":{"description":"Eastern edge of a bounding-box search, in degrees.","type":"number","minimum":-360,"maximum":360},"min_depth_km":{"description":"Minimum depth in kilometers. Bounded to the documented -100 to 1000 km catalog envelope. Shallow quakes (0–70 km) typically cause more surface damage than deep quakes (>300 km).","type":"number","minimum":-100,"maximum":1000},"max_depth_km":{"description":"Maximum depth in kilometers. Bounded to the documented -100 to 1000 km catalog envelope.","type":"number","minimum":-100,"maximum":1000},"alert_level":{"description":"Minimum PAGER alert level. PAGER estimates economic loss and casualties. \"green\" = minimal impact; \"red\" = extreme. Only available from USGS.","type":"string","enum":["green","yellow","orange","red"]},"min_felt":{"description":"Minimum number of DYFI (Did You Feel It?) reports. Use to count events with confirmed public impact. Only available from USGS.","type":"integer","minimum":1,"maximum":9007199254740991},"min_significance":{"description":"Minimum USGS significance score (0–2000+). Combines magnitude, felt reports, and PAGER estimates. Significant events typically score 600+. Only available from USGS.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"event_type":{"description":"Filter by upstream event classification, e.g. \"earthquake\" to exclude quarry blasts and explosions from the count, or \"quarry blast\" to count only those. Matched verbatim against the USGS catalog, which accepts any string and returns a count of zero for an unrecognized one. Only available from USGS.","type":"string","minLength":1},"source":{"default":"usgs","description":"Data source. Both catalogs are global. \"usgs\" covers global events with PAGER, DYFI, and ShakeMap metadata. \"emsc\" is an independent global catalog operated by the European-Mediterranean Seismological Centre — use it to cross-check a count from a separate network. It has no PAGER, DYFI, or ShakeMap metadata; its station coverage is densest around Europe and the Mediterranean, so counts of small events differ most by region.","type":"string","enum":["usgs","emsc"]}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"earthquake_get_event","description":"Fetch detail for a specific earthquake by USGS event ID. Returns the same normalized event a search result carries, plus a projection of the analysis products only the single-event response holds: PAGER impact alert and report link, ShakeMap peak intensity and ground motion, DYFI felt-report totals, the moment-tensor focal mechanism, landslide and liquefaction alerts, origin quality (azimuthal gap, station count, location uncertainty), and finite-fault rupture dimensions. Products are omitted when USGS produced none — a small automatic event typically has no detail at all, while a large reviewed one has most of it. 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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"event_id":{"type":"string","description":"USGS event ID, e.g. \"hv74966427\" or \"us6000sznj\". Found in the \"id\" field of earthquake_get_feed and earthquake_search results."}},"required":["event_id"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"earthquake_get_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, so results are returned a page at a time: count is the page size, totalCount the whole feed, and nextCursor the input for the following page. The cursor is opaque and must be passed back verbatim — unlike earthquake_search, these feeds have no upstream paging parameter and USGS regenerates them about once a minute, so a numeric offset across two calls would skip or repeat events. For historical or filtered queries, use earthquake_search instead.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"magnitude_tier":{"default":"2.5","description":"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.","type":"string","enum":["all","1.0","2.5","4.5","significant"]},"time_window":{"default":"day","description":"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.","type":"string","enum":["hour","day","week","month"]},"limit":{"description":"Maximum events to return in this call. Default 100, max 1000. Applies to the first page; later pages carry the page size inside the cursor, so set it on the first call rather than changing it mid-sequence.","type":"integer","minimum":1,"maximum":1000},"cursor":{"description":"Opaque token for the next page, taken verbatim from a previous call's nextCursor. Omit for the first page. Do not construct, parse, or edit it — it encodes a position in the feed snapshot and is rejected if malformed.","type":"string"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"earthquake_search","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, an independent global catalog operated by the European-Mediterranean Seismological Centre. For location-based queries, provide latitude, longitude, and radius_km together. A rectangular study area is expressed with min_latitude, max_latitude, min_longitude, and max_longitude — each independently optional, so a single edge is a valid constraint. Combining the box with the lat/lon/radius circle intersects the two, returning only events inside both. Both catalogs include non-tectonic records (quarry blasts, explosions) — every event carries its event_type, and event_type=\"earthquake\" filters the rest out on USGS. USGS-specific filters (alert_level, event_type, min_felt, min_significance) are not sent when source=emsc — the response names them in ignoredFilters. Use earthquake_count first to gauge result size before requesting large result sets. A single call returns at most 20,000 events; larger result sets are retrieved by paging with offset, which is passed straight through to the upstream FDSN API. When a result is capped, nextOffset carries the offset for the following page and totalCount the full match count — or countUnavailable reports that the count lookup failed and the total is unknown.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"start_time":{"description":"Start of time range as ISO 8601 (e.g. \"2026-01-01\" or \"2026-05-23T00:00:00\"). A bare year expands to January 1st and an unpadded month or day is zero-padded, so both sources honor the same window. Defaults to 30 days before end_time (or before the current time) if omitted — applied server-side so USGS and EMSC honor the same window.","type":"string","pattern":"^\\d{4}(-\\d{1,2}(-\\d{1,2})?)?([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$"},"end_time":{"description":"End of time range as ISO 8601, in the same forms start_time accepts. Defaults to current time if omitted.","type":"string","pattern":"^\\d{4}(-\\d{1,2}(-\\d{1,2})?)?([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$"},"min_magnitude":{"description":"Minimum magnitude (Richter or equivalent). M2.5+ is felt by some people; M5+ can cause damage; M7+ is major.","type":"number","minimum":-1,"maximum":10},"max_magnitude":{"description":"Maximum magnitude.","type":"number","minimum":-1,"maximum":10},"latitude":{"description":"Latitude for radius search. Requires longitude and radius_km.","type":"number","minimum":-90,"maximum":90},"longitude":{"description":"Longitude for radius search. Requires latitude and radius_km.","type":"number","minimum":-180,"maximum":180},"radius_km":{"description":"Search radius in kilometers from the lat/lon point. 100 km covers a metro region; 500 km covers a large country. Max 20001.6, the ceiling USGS enforces. Converted to degrees for EMSC (1° ≈ 111.2 km).","type":"number","minimum":0,"maximum":20001.6},"min_latitude":{"description":"Southern edge of a bounding-box search, in degrees. Independent of the other three box parameters — supply any of them. Must not exceed max_latitude when both are given.","type":"number","minimum":-90,"maximum":90},"max_latitude":{"description":"Northern edge of a bounding-box search, in degrees.","type":"number","minimum":-90,"maximum":90},"min_longitude":{"description":"Western edge of a bounding-box search, in degrees. Range extends beyond ±180 so a box can cross the antimeridian (e.g. min_longitude=170, max_longitude=190) — always keep min_longitude at or below max_longitude rather than inverting the pair.","type":"number","minimum":-360,"maximum":360},"max_longitude":{"description":"Eastern edge of a bounding-box search, in degrees.","type":"number","minimum":-360,"maximum":360},"min_depth_km":{"description":"Minimum depth in kilometers. Bounded to the documented -100 to 1000 km catalog envelope. Shallow quakes (0–70 km) typically cause more surface damage than deep quakes (>300 km).","type":"number","minimum":-100,"maximum":1000},"max_depth_km":{"description":"Maximum depth in kilometers. Bounded to the documented -100 to 1000 km catalog envelope.","type":"number","minimum":-100,"maximum":1000},"alert_level":{"description":"Minimum PAGER alert level. PAGER estimates economic loss and casualties. \"green\" = minimal impact; \"red\" = extreme. Only available from USGS.","type":"string","enum":["green","yellow","orange","red"]},"min_felt":{"description":"Minimum number of DYFI (Did You Feel It?) reports. Use to find events with confirmed public impact. Only available from USGS.","type":"integer","minimum":1,"maximum":9007199254740991},"min_significance":{"description":"Minimum USGS significance score (0–2000+). Combines magnitude, felt reports, and PAGER estimates. Significant events typically score 600+. Only available from USGS.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"event_type":{"description":"Filter by upstream event classification, e.g. \"earthquake\" to exclude quarry blasts and explosions, or \"quarry blast\" to see only those. Matched verbatim against the USGS catalog, which accepts any string and returns zero matches for an unrecognized one. Only available from USGS.","type":"string","minLength":1},"source":{"default":"usgs","description":"Data source. Both catalogs are global. \"usgs\" covers global events with PAGER, DYFI, and ShakeMap metadata. \"emsc\" is an independent global catalog operated by the European-Mediterranean Seismological Centre — use it to cross-check any event, anywhere, against a separate network. It publishes no PAGER, DYFI, or ShakeMap metadata and no per-event detail endpoint; its station coverage is densest around Europe and the Mediterranean.","type":"string","enum":["usgs","emsc"]},"limit":{"description":"Maximum events to return per call. Default 100. Large limits (>1000) may result in slow responses. Max 20000. Combine with offset to retrieve match sets larger than one call can return.","type":"integer","minimum":1,"maximum":20000},"offset":{"description":"Index of the first event to return, counting from 1 — offset=1 is the first match (both upstream APIs reject 0). Omit for the first page, then pass the nextOffset value from a capped result to fetch the next one. Ordering is set by order_by, so keep order_by, limit, and every filter identical across pages.","type":"integer","minimum":1,"maximum":9007199254740991},"order_by":{"default":"time","description":"Sort order. \"time\" returns newest first; \"magnitude\" returns largest first.","type":"string","enum":["time","time-asc","magnitude","magnitude-asc"]}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}}],"scan":{"score":93,"grade":"A","scanned_at":"2026-09-19T20:04:45.241Z","report":{"scannerVersion":"0.1.5","scannedAt":"2026-09-19T20:04:45.236Z","components":{"code":{"score":25,"max":25,"notes":["30 source files scanned","30 source files scanned"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 997ms"]},"poisoning":{"score":15,"max":15,"notes":["4 tool descriptions checked"]},"auth":{"score":10,"max":15,"notes":["open endpoint, read-only tools"]},"maintenance":{"score":15,"max":15,"notes":["last push 0 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"probes":[{"url":"https://earthquake.caseyjhand.com/mcp","reachable":true,"authRequired":false,"latencyMs":997,"serverInfo":{"name":"earthquake-mcp-server","version":"0.3.6"}}],"packages":[{"registryType":"npm","identifier":"@cyanheads/earthquake-mcp-server","version":"0.3.6","found":true,"license":"Apache-2.0","hasInstallScripts":false,"dependencyCount":3,"publishedAt":"2026-09-19T18:54:15.895Z","repositoryUrl":"git+https://github.com/cyanheads/earthquake-mcp-server.git","weeklyDownloads":288},{"registryType":"npm","identifier":"@cyanheads/earthquake-mcp-server","version":"0.3.6","found":true,"license":"Apache-2.0","hasInstallScripts":false,"dependencyCount":3,"publishedAt":"2026-09-19T18:54:15.895Z","repositoryUrl":"git+https://github.com/cyanheads/earthquake-mcp-server.git","weeklyDownloads":288}],"repo":{"found":true,"owner":"cyanheads","repo":"earthquake-mcp-server","archived":false,"pushedAt":"2026-09-19T18:53:05Z","stars":1,"forks":0,"openIssues":4,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/10339515?v=4","ownerCreatedAt":"2014-12-29T13:01:12Z","license":"Apache-2.0"},"icon":{"url":"https://avatars.githubusercontent.com/u/10339515?v=4&s=128","source":"registry"},"presence":{"stars":1,"forks":0,"downloadsWeek":576,"license":"Apache-2.0","lastPushAt":"2026-09-19T18:53:05.000Z","score":37}}}},"grade_history":[],"reviews":[]}