[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [USGS earthquake search](https://spiral.ai/integrations/cursor/usgs-earthquake-search)

# How to Use USGS earthquake search in Cursor

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.

|  |  |
| --- | --- |
| Model | USGS earthquake search |
| Available through | Alexandria |
| Category | Public Records |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with USGS earthquake search in Cursor

- Use USGS earthquake search to retrieve events within 100 km of Los Angeles at 34.0522, -118.2437 during July 2019, and add a timeline of origin times, magnitudes, and depths to this project's data folder.
- Use USGS earthquake search to retrieve events within 150 km of Anchorage at 61.2181, -149.9003 during November 2018, and build a map from the returned coordinates.
- Use USGS earthquake search to retrieve events within 100 km of Ridgecrest at 35.6225, -117.6709 from July 4 through July 8, 2019, and generate a chart of magnitude against origin time.
- Use USGS earthquake search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from USGS earthquake search and tell me what changed since last week.

## How to set up USGS earthquake search in Cursor

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to Cursor on the console's Agents & MCP page, or add this to `.cursor/mcp.json` (one project) or `~/.cursor/mcp.json` (every project):

```json
{
  "mcpServers": {
    "spiral": { "url": "https://api.spiral.ai/mcp" }
  }
}
```

2. **Sign in**: Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.

### Use the Spiral skill

1. **Send Cursor this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run USGS earthquake search**: One request; the result comes back by polling or a webhook.

```bash
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: Cursor finds USGS earthquake search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/cursor

## USGS earthquake search tools and prices

- [USGS Earthquake Catalog (ComCat) · Search](https://spiral.ai/tools/alexandria/earthquake-usgs-gov/earthquakes/search) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 200 | 50 | Events per page. |
| cursor |  | — | next_cursor from the previous page of the same search. Pattern: ^[0-9]{1,5}$. |
| end_time |  | — | Latest origin time (inclusive), UTC, same formats. A bare date means 00:00:00 of that day. Defaults to now. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(T[0-9]{2}:[0-9]{2}(:[0-9]{2}(\.[0-9]{1,3})?)?)?Z?$. |
| latitude | -90 to 90 | — | Circle center latitude; requires longitude and max_radius_km. |
| order_by | time, time-asc, magnitude, magnitude-asc | time | Newest first (time), oldest first, largest first (magnitude) or smallest first. |
| longitude | -180 to 180 | — | Circle center longitude. |

## What can you do with USGS earthquake search in Cursor?

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.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Cursor guides](https://spiral.ai/integrations/cursor)

## USGS earthquake search in other agents

- [Amp](https://spiral.ai/integrations/amp/usgs-earthquake-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/usgs-earthquake-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/usgs-earthquake-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/usgs-earthquake-search)
- [Cline](https://spiral.ai/integrations/cline/usgs-earthquake-search)
- [Codex](https://spiral.ai/integrations/codex/usgs-earthquake-search)
- [Devin](https://spiral.ai/integrations/devin/usgs-earthquake-search)
- [dots](https://spiral.ai/integrations/dots/usgs-earthquake-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/usgs-earthquake-search)
- [Gemini](https://spiral.ai/integrations/gemini/usgs-earthquake-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/usgs-earthquake-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/usgs-earthquake-search)
- [goose](https://spiral.ai/integrations/goose/usgs-earthquake-search)
- [Grok](https://spiral.ai/integrations/grok/usgs-earthquake-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/usgs-earthquake-search)
- [Hermes](https://spiral.ai/integrations/hermes/usgs-earthquake-search)
- [Instinct](https://spiral.ai/integrations/instinct/usgs-earthquake-search)
- [Manus](https://spiral.ai/integrations/manus/usgs-earthquake-search)
- [Muse](https://spiral.ai/integrations/muse/usgs-earthquake-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/usgs-earthquake-search)
- [n8n](https://spiral.ai/integrations/n8n/usgs-earthquake-search)
- [Notion](https://spiral.ai/integrations/notion/usgs-earthquake-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/usgs-earthquake-search)
- [opencode](https://spiral.ai/integrations/opencode/usgs-earthquake-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/usgs-earthquake-search)
- [Raycast](https://spiral.ai/integrations/raycast/usgs-earthquake-search)
- [VS Code](https://spiral.ai/integrations/vscode/usgs-earthquake-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/usgs-earthquake-search)
- [Zapier](https://spiral.ai/integrations/zapier/usgs-earthquake-search)

## More Cursor guides

- [USGS earthquake details](https://spiral.ai/integrations/cursor/usgs-earthquake-details)
- [V-Dem country coverage](https://spiral.ai/integrations/cursor/v-dem-country-coverage)
- [USDOT NAD release status](https://spiral.ai/integrations/cursor/usdot-nad-release-status)
- [V-Dem dataset releases](https://spiral.ai/integrations/cursor/v-dem-dataset-releases)
- [USDOT NAD address points](https://spiral.ai/integrations/cursor/usdot-nad-address-points)
- [V-Dem democracy scores](https://spiral.ai/integrations/cursor/v-dem-democracy-scores)

## Questions about USGS earthquake search in Cursor

**Can Cursor use USGS earthquake search?**

Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run USGS earthquake search like any built-in tool.

**How much does USGS earthquake search cost in Cursor?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Cursor plan is separate.

**Do I need an Alexandria account to use USGS earthquake search in Cursor?**

No. Spiral runs USGS earthquake search 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 search in Cursor?**

About two minutes: add the hosted server, then sign in.

**Does Cursor wait while USGS earthquake search runs?**

USGS earthquake search runs in the background. Cursor 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.

