drio
Open app

usgs-quakes-mcp

Source

An MCP server for querying the USGS Earthquake API with natural language

Catalog onlyCatalog onlySTDIO

Overview

The usgs-quakes-mcp project is an MCP server that enables users to query the USGS Earthquake API using natural language, providing an intuitive way to access earthquake data.

To use the server, you need to install Node.js, clone the repository, and configure it with Claude Desktop to run queries that fetch earthquake information based on user-defined criteria.

  • Natural language queries for fetching earthquake data - Ability to receive comprehensive details about specific earthquakes - Easy integration with Claude Desktop for enhanced functionality
  1. Finding earthquakes above a certain magnitude in a specific region over a set period.
  2. Getting detailed information about a particular earthquake based on its event ID.
  3. Researching historical earthquake activity in various geographical locations.

Add to your AI client

Use these steps to connect usgs-quakes-mcp in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "usgs-quakes-mcp-blake365": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-usgs-quakes-mcp-blake365"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "usgs-quakes-mcp-blake365": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-usgs-quakes-mcp-blake365"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "usgs-quakes-mcp-blake365": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-usgs-quakes-mcp-blake365"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "usgs-quakes-mcp-blake365": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-usgs-quakes-mcp-blake365"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "usgs-quakes-mcp-blake365": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-usgs-quakes-mcp-blake365"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "usgs-quakes-mcp-blake365": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-usgs-quakes-mcp-blake365"
      ]
    }
  }
}

FAQ

What kind of queries can I run?

You can run various queries such as finding earthquakes by magnitude, location, and date range using natural language.

Do I need any special software to run this project?

Yes, you will need Node.js and Claude Desktop to properly run the server.

Is this server able to give real-time data?

The server provides access to the USGS data, which is updated regularly but may not always reflect real-time events.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":501,"uuid":"57dbc0ce-3ab1-487c-ac5c-0800caa32da5","name":"usgs-quakes-mcp","title":"usgs-quakes-mcp","description":"An MCP server for querying the USGS Earthquake API with natural language","avatar_url":"https://avatars.githubusercontent.com/u/68243611?v=4","created_at":"2024-12-30T02:52:12.292Z","updated_at":"2025-01-05T03:00:07.858Z","status":"created","author_name":"blake365","author_avatar_url":"https://avatars.githubusercontent.com/u/68243611?v=4","tags":"usgs-api,claude,usgs-earthquake,modelcontextprotocol","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/blake365/usgs-quakes-mcp","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/dc03b5367d2c8afcc7542c9133973185bfe300e1274c06be93b55fc5c8636f32/68747470733a2f2f736d6974686572792e61692f62616467652f40626c616b653336352f757367732d7175616b65732d6d6370","type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Research and data
usgs-quakes-mcp — MCP Registry