Skip to content
MCP server

Earthquake MCP Server

Search USGS and EMSC seismic data — real-time feeds, event queries, and earthquake counts.

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.5.2
Listing updated
4 days ago

About Earthquake MCP Server

Earthquake MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

Install

Run in a terminal

claude mcp add --transport http earthquake-mcp-server https://earthquake.caseyjhand.com/mcp

Add to Settings → Connectors → Add custom connector

https://earthquake.caseyjhand.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "earthquake-mcp-server": {
      "url": "https://earthquake.caseyjhand.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "earthquake-mcp-server": {
      "type": "http",
      "url": "https://earthquake.caseyjhand.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "earthquake-mcp-server": {
      "serverUrl": "https://earthquake.caseyjhand.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "earthquake-mcp-server": {
      "type": "http",
      "url": "https://earthquake.caseyjhand.com/mcp"
    }
  }
}

Configuration

  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • USGS_BASE_URLUSGS API base URL. Override for testing or mirroring.
  • EMSC_BASE_URLEMSC API base URL. Override for testing or mirroring.
  • DEFAULT_LIMITEvents earthquake_search_events returns when a call omits limit (1-1000).
  • REQUEST_TIMEOUT_MSPer-attempt HTTP timeout in milliseconds (1000-120000). Every feed, search, count, and event call also runs under one 50-second total deadline across its requests and retries.
  • EARTHQUAKE_CLAMP_LIMITSClamp a search or feed limit above 1000 to 1000 with a notice. Set false to advertise and enforce a maximum of 1000 instead.
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_TRANSPORT_TYPESelects the HTTP transport.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Pricing

Open source

Earthquake MCP Server FAQ

Is Earthquake MCP Server free?

Yes. Earthquake MCP Server is open source, so you can use and self-host it for free.

How do I add Earthquake MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http earthquake-mcp-server https://earthquake.caseyjhand.com/mcp