How to Use USGS earthquake search in Instinct
Find cataloged seismic events and their magnitude, location, depth, and origin time within a region and time window. Use it to build an earthquake timeline or find event IDs for closer investigation.
Prompts to try with USGS earthquake search in Instinct
Copy an example into Instinct, or ask in your own words.
Every morning, use USGS earthquake search to summarize events within 150 km of Anchorage during the previous day, with magnitude, depth, and origin time.
Every six hours, use USGS earthquake search to check the past 48 hours within 100 km of the Port of Los Angeles and report new events and changed magnitudes.
Each evening, use USGS earthquake search to prepare a digest of events within 100 km of San Francisco over the previous 24 hours, newest first.
Every Monday at 9am: use USGS earthquake search to look this up and give me the result as a table.
Pull the latest numbers from USGS earthquake search and tell me what changed since last week.
How to set up USGS earthquake search in Instinct
Pick the way that suits you. Each takes about two minutes.
Use the Spiral skill
- Send Instinct 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 Spiral's MCP server
- Create an API key
In the console, open API keys and create a key for Instinct. Copy it.
- Send Instinct this message
Instinct reads Spiral's skill and asks for your API key.
set up https://spiral.ai/SKILL.md
- Give Instinct the key
When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.
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 search
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/search", "input": { "limit": 50 } }'
Then paste one of the prompts above: Instinct finds USGS earthquake search on Spiral, shows the price and runs it.
USGS earthquake search providers and prices
Spiral runs USGS earthquake search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Instinct for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Limit | 1 to 200 | 50 | Events per page. |
| Latitude | -90 to 90 | Circle center latitude; requires longitude and max_radius_km. | |
| Order by | time, time-asc, magnitude, or magnitude-asc | time | Newest first (time), oldest first, largest first (magnitude) or smallest first. |
| Longitude | -180 to 180 | Circle center longitude. | |
| Alert level | green, yellow, orange, or red | Only events with this PAGER alert level. | |
| Max depth km | -100 to 1000 | max_depth_km | |
| Max latitude | -90 to 90 | Rectangle north edge. | |
| Min depth km | -100 to 1000 | min_depth_km | |
| Min latitude | -90 to 90 | Rectangle south edge. Rectangle edges may be given in any subset; do not combine with the circle. | |
| Max longitude | -360 to 360 | Rectangle east edge. | |
| Max magnitude | -2 to 10 | max_magnitude | |
| Max radius km | 0 to 20001.6 | Circle radius in kilometres. | |
| Min longitude | -360 to 360 | Rectangle west edge; values beyond +/-180 let a rectangle cross the antimeridian. | |
| Min magnitude | -2 to 10 | min_magnitude |
Every API field of USGS Earthquake Catalog (ComCat) · Search is on its tool page: open its card above.
What can you do with USGS earthquake search in Instinct?
Maintain a daily earthquake digest for a city or public facility and identify changes in previously retrieved records. Separate new catalog entries from revisions to magnitude, depth, and available impact 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 search and Instinct
Overview
USGS earthquake search in other agents
Questions about USGS earthquake search in Instinct
Can Instinct use USGS earthquake search?
Yes. Add Spiral to Instinct as an MCP server, and Instinct can find and run USGS earthquake search like any built-in tool.
How much does USGS earthquake search cost in Instinct?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Instinct plan is separate.
Do I need an Alexandria account to use USGS earthquake search in Instinct?
You need no Alexandria account. Instinct uses one Spiral API key for every tool, and Spiral runs USGS earthquake search on its own Alexandria account.
How long does it take to set up USGS earthquake search in Instinct?
About two minutes: create an API key, then send Instinct this message, then give Instinct the key.
Does Instinct wait while USGS earthquake search runs?
USGS earthquake search runs in the background. Instinct 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 search in Instinct
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Instinct:
set up https://spiral.ai/SKILL.md


