USGS Earthquake Research
LiveResearch earthquake records with dates, locations and source links.
Search the USGS public earthquake catalog by UTC date range, minimum magnitude and optional geographic radius. Retrieve individual event metadata with source links, magnitude, depth and review status.
Connect / 2 tools
Server URL
https://toolcargo.com/mcp/usgs-earthquakesClaude Code
claude mcp add --transport http --scope user toolcargo-usgs-earthquakes https://toolcargo.com/mcp/usgs-earthquakes \
--header "Authorization: Bearer YOUR_API_KEY"Create a key in your dashboard. Other clients: setup guides.
What it helps you do
- Source-linked earthquake catalog records
- UTC dates and coordinates with clear units
- Individual event details and review status
Built for: Researchers, writers and agents checking historical earthquake records.
Example requests
Research a historical sequence
“Search USGS earthquake records from 2023-02-06 to 2023-02-07 with magnitude at least 7, then look up the largest event's ID.”
Bounded catalog records and source-linked event metadata for further research.
Tools
| Tool | What it does | Access |
|---|---|---|
usgs_search_earthquakesSearch earthquake records | Search the USGS catalog within a UTC date window of at most 31 days, with an exclusive end date, minimum magnitude and optional location radius. Returns up to 20 source-linked records ordered newest first with pagination. Research metadata, not alerts or forecasts. One shared-plan call. | Read-only |
usgs_get_earthquakeLook up an earthquake event | Retrieve one USGS earthquake by event ID with magnitude, UTC event/update times, place, coordinates, depth in kilometers and review status. Excludes product files and emergency interpretations. One shared-plan call. | Read-only |
Requirements
- • A ToolCargo account with Site Audit activated (free). No USGS account or external API key.
Limitations
- • Search windows are at most 31 days, with up to 20 events per page and offsets from 1 to 20000.
- • Location searches require latitude, longitude and a radius of 0.1–2000 km together.
- • Catalog records can be revised, incomplete or automatically generated; coverage varies by region and period.
- • Research metadata only. No real-time alerting, forecasts, product downloads or emergency guidance.
Supported clients
“Tested” means we connected that client to this endpoint and ran a tool call ourselves. Recorded client-specific tests currently cover Site Audit. Other connectors use the documented setup until tested in that client.
| Claude Code | API key header | Documented, not yet tested | This endpoint has not yet been tested in this client. See the setup guide. |
| Claude (claude.ai) | OAuth sign-in | Documented, not yet tested | This endpoint has not yet been tested in this client. See the setup guide. |
| Cursor | API key header | Documented, not yet tested | This endpoint has not yet been tested in this client. See the setup guide. |
| VS Code (Copilot agent mode) | API key header | Documented, not yet tested | This endpoint has not yet been tested in this client. See the setup guide. |
| ChatGPT (developer mode) | OAuth sign-in | Documented, not yet tested | This endpoint has not yet been tested in this client. See the setup guide. |
| MCP Inspector | API key header | Documented, not yet tested | This endpoint has not yet been tested in this client. See the setup guide. |
More in Research
- Crossref Research LiveFind scholarly publications and check their citation details.
- DataCite Dataset Research LiveFind research datasets and check their DOI metadata.
- Europe PMC Research LiveFind life-sciences publications and check citation metadata.
- GBIF Biodiversity Research LiveFind species taxonomy and summarize indexed occurrence records.
Pricing
Included with Site Audit. Each search or event lookup is one shared-plan call.
Free
$0Try hosted tools with a shared monthly allowance.
50 shared calls/month
Pro
$12/moProposed larger shared allowance; see checkout status on the pricing page.
2,000 shared calls/month
Proposed test price. See the pricing page for checkout status.