How to Use USGS earthquake details in Claude Code
Get one earthquake's magnitude, location, depth, and available ShakeMap, PAGER, and felt-report summaries. Use a known event ID to examine shaking and estimated impacts or check how the record has changed.
Prompts to try with USGS earthquake details in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use USGS earthquake details for us7000dflf and create a fixture containing the returned magnitude, location, depth, and available shaking and impact summaries.
Use USGS earthquake details for us1000g3ub and add an event summary component that labels PAGER losses as estimates and DYFI responses as public reports.
Use USGS earthquake details to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from USGS earthquake details and tell me what changed since last week.
Check USGS earthquake details and summarize what you find in three bullet points.
How to set up USGS earthquake details in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run USGS earthquake details
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "earthquake-usgs-gov/earthquakes/event", "input": { "id": "<id>" } }'
Then paste one of the prompts above: Claude Code finds USGS earthquake details on Spiral, shows the price and runs it.
USGS earthquake details providers and prices
Spiral runs USGS earthquake details through Alexandria. Open a card for today's price, with every fee included.
What can you do with USGS earthquake details in Claude Code?
Build a regional earthquake timeline with magnitude, depth, and links to USGS records. Add individual event summaries that distinguish ShakeMap intensity, DYFI reports, and PAGER estimates.
Earthquake news briefs
Find events around a reported earthquake, then inspect the selected event's magnitude, depth, shaking, and available impact estimates to draft a sourced newsroom brief.
Regional earthquake timelines
Build a dated sequence for a region such as Southern California and add available shaking and felt-report summaries for selected events.
Business incident context
Prepare an earthquake briefing near a public facility such as the Port of Los Angeles, using catalog locations and available impact summaries to support further investigation.
Earth science lessons
Compare magnitude, depth, ShakeMap intensity, and public felt reports across selected earthquakes to explain the different measurements.
Catalog revision reports
Compare repeated retrievals for a regional event list or a known earthquake and report changes to magnitude, depth, location, and available impact summaries.
Historical event comparisons
Find earthquakes within defined historical windows and assemble comparable event summaries, keeping differences in catalog coverage visible.
More on USGS earthquake details and Claude Code
Overview
USGS earthquake details in other agents
Questions about USGS earthquake details in Claude Code
Can Claude Code use USGS earthquake details?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run USGS earthquake details like any built-in tool.
How much does USGS earthquake details cost in Claude Code?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.
Do I need an Alexandria account to use USGS earthquake details in Claude Code?
No. Spiral runs USGS earthquake details on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up USGS earthquake details in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while USGS earthquake details runs?
USGS earthquake details runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.
Does USGS cover earthquakes outside the United States?
Yes. ComCat receives earthquake parameters and related products from seismic networks worldwide. Geographic coverage and periods of record vary by contributing catalog.
How fresh is an individual earthquake record?
USGS says event pages and GeoJSON detail are cached for one minute during the first seven days after an event, then for 15 minutes. Those are cache intervals, not a promise that new observations arrive on that schedule.
Why do so many records show a depth of exactly 10 km?
USGS sometimes assigns a depth of 10 km when the available observations cannot support a reliable depth calculation. That value can be a fixed estimate rather than a precisely measured depth.
Are PAGER fatalities and losses confirmed totals?
No. PAGER provides estimated fatalities and economic losses following significant earthquakes worldwide. Describe these as modeled impacts when preparing an earthquake brief.
Is there a limit on large historical searches?
The underlying USGS catalog service caps a query at 20,000 events and rejects queries exceeding that limit. Divide broad historical work into smaller time windows.
Start using USGS earthquake details in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


