USGS Earthquake Data

by blake365

1 stars

228 downloads

Not rated

GitHub

About

Integrates with USGS earthquake data to provide real-time access for querying and analyzing seismic events, enabling applications in disaster response, geological research, and risk assessment.

Details

Author: blake365
Repository: blake365/usgs-quakes-mcp
GitHub stars: 1
Downloads: 228
License: MIT License
Categories: Search, Other, AI, Design, Developer Tools, Infrastructure, Automation, Frontend, API

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name USGS Earthquake Data

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 usgs-quakes-mcp
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "npx"
        }
    }
}

From the repository

Install via Smithery with npx -y @smithery/cli install @blake365/usgs-quakes-mcp --client claude, or manually by cloning the repo and configuring Claude Desktop’s claude_desktop_config.json to point to the built index.js. Once set up, users can ask questions about earthquakes in plain language.

`find-earthquakes`

Search for earthquakes using parameters such as time, bounding box, radius, magnitude, and depth.

`count-earthquakes`

Count the number of earthquake matches based on a query without returning the event details.

`find-earthquake-details`

Retrieve full details for a specific earthquake event using its event ID, including origin quality metrics.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "usgs earthquake data": {
            "env": {},
            "args": [
                "-y",
                "usgs-quakes-mcp"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "usgs-quakes-mcp"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "usgs-quakes-mcp"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "usgs-quakes-mcp"
    ],
    "command": "cmd"
}

MCP server for the USGS earthquake catalog

An MCP server providing access to theUSGS FDSN event APIfrom Claude Desktop, Claude Code, and any other MCP client.

No API key required — the USGS service is free and public.

This Model Context Protocol (MCP) server enables AI assistants and applications to:

- Get earthquake data through a wide variety of search parameters
- Get details about a specific earthquake

Users can run queries using natural language.

Q: find earthquakes over 2 magnitude in florida over the last 20 years

A:I'll help you search for earthquakes in Florida with a magnitude greater than 2.0 over the past 20 years.

View Result from find-earthquakes from usgs-quakes (local)

{ "endTime": "2024-12-28T23:59:59", "startTime": "2004-12-28T00:00:00", "maxLatitude": 31.000888, "minLatitude": 24.396308, "maxLongitude": -80.031362, "minLongitude": -87.634896, "minmagnitude": 2 }

Based on the USGS earthquake data, there have been three notable earthquakes in or near Florida over the past 20 years:
-

A magnitude 5.9 earthquake in the Gulf of Mexico on September 10, 2006 Located offshore at coordinates 26.319°N, 86.606°W Depth: 14 km This was the largest earthquake in the region during this period It was widely felt, with 5,763 people reporting feeling the quake

A magnitude 2.8 earthquake near Jay, Florida on March 6, 2019 Located at coordinates 30.9718°N, 87.1719°W Depth: 5 km 49 people reported feeling this earthquake

A magnitude 2.7 earthquake near Century, Florida on March 24, 2019 Located at coordinates 30.9622°N, 87.2384°W Depth: 5 km 4 people reported feeling this earthquake

It's worth noting that Florida experiences relatively few earthquakes compared to more seismically active regions of the United States. The two 2019 earthquakes occurred in the Florida panhandle, while the larger 2006 event was offshore in the Gulf of Mexico.

Q: get the details of the Jay Florida earthquake

A:I'll get the detailed information about the magnitude 2.8 earthquake that occurred near Jay, Florida.

View Result from find-earthquake-details from usgs-quakes (local)

{ "eventid": "us1000jbw4" }

Here are the key details about the Jay, Florida earthquake: Date and Time: March 7, 2019, at 04:45:52 UTC Location: 2 km (1.2 miles) Northwest of Jay, Florida Coordinates: 30.9718°N, 87.1719°W Depth: 5 kilometers (3.1 miles) Magnitude: 2.8 mb_lg (body wave magnitude)

- 49 people reported feeling the earthquake
- The Community Internet Intensity Map (CIIM) showed a maximum intensity of 2.7
- There was no tsunami generated
- The earthquake was reviewed and confirmed by USGS scientists
- The location had a horizontal error margin of about 6.2 km
- The magnitude calculation used data from 11 seismic stations
- The earthquake was also detected by the New Mexico seismic network (NM), which calculated a slightly different magnitude of 2.63

- Azimuthal gap: 243 degrees (indicates moderate coverage by seismic stations)
- RMS error: 0.59 (indicates reasonable quality of the location estimate)
- Minimum distance to nearest station: 0.222 degrees
- Standard error for magnitude: 0.154

This was a relatively minor earthquake, but notable for Florida which rarely experiences seismic activity. The fact that it was felt by 49 people suggests it was noticeable to residents in the immediate area, though no significant damage would be expected from an earthquake of this magnitude.

Requires Node.js 20 or newer. No install step is needed —npxfetches the server on first run.
-

Open your Claude Desktop configuration at:

- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "usgs-quakes": { "command": "npx", "args": ["-y", "usgs-quakes-mcp"] } } }

claude mcp add usgs-quakes -- npx -y usgs-quakes-mcp

The server speaks MCP over STDIO. Run it withnpx -y usgs-quakes-mcp, or install it globally withnpm install -g usgs-quakes-mcpand runusgs-quakes-mcp.

- find-earthquakes— search by time, bounding box, radius, magnitude, and depth
- count-earthquakes— count matches without returning events, to size a query first
- find-earthquake-details— full detail for one event id, including origin quality metrics

Data comes from theUSGS FDSN event web service. The service caps any single query at 20,000 events.

npm install # install dependencies npm run dev # run from source over STDIO, no build step npm run build # compile TypeScript to build/ npm run typecheck # type-check without emitting

src/server.tsholds all the tools and API calls — that is the file to edit.src/index.tsis just the STDIO entry point.

To point Claude Desktop at a local build instead of the published package, use"command": "node"with"args": ["/full/path/to/usgs-quakes/build/index.js"], and restart Claude Desktop after each rebuild.

If Claude Desktop cannot findnpx, provide its full path (on macOS, typically/usr/local/bin/npxor/opt/homebrew/bin/npx). The same applies tonodeif you are running a local build.

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Provides airfield aeronautical information for general aviation private pilots like runways, fuel prices, landing fees, weather, webcams and more

Access Oceanic and Atmospheric Data using AI Agents

Swiss open data MCP server — transport, weather, geodata, companies, etc,. Zero API keys.

Weather data from the Mt Washington weather observatory in New Hampshire.

Weather forecasts, air quality, UV index, historical data, and alerts for AI agents. 5 tools, powered by Open-Meteo, free, unlimited, no API key.

Provides access to USDA SNOTEL weather and snow data.

Provides real-time and forecast WBGT (Heat Index) data for Tokyo from Japan's Ministry of the Environment.

A lightweight Model Context Protocol (MCP) server that exposes Greenbook data and tools for market research professionals, analysts, and related workflows.

An MCP (Model Context Protocol) server for searching and analyzing academic papers across multiple databases (Semantic Scholar, Crossref, OpenAlex, PubMed), with regex-powered filtering and statistical analysis.

US land due-diligence MCP — returns solar potential, groundwater depth, flood zones, and county regulations for any property address.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

find-earthquakes

count-earthquakes

find-earthquake-details

Claude Desktop / Cursor

Linux

Macos

Windows

Install

More like this

Sequential Thinking

Brave Search

Filesystem

EverArt

Google Drive

Context 7

`find-earthquakes`

`count-earthquakes`

`find-earthquake-details`