Spiral gives your agent every tool with one account. Browse the tools →

Cursor · Public Records

How to Use USGS earthquake details in Cursor

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 Cursor

Copy an example into Cursor, 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.

USGS earthquake detailsCursor
Try asking
  • 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 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):

    {
      "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.

    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 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: Cursor 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.

AlexandriaPublic Records
USGS Earthquake Catalog (ComCat) · Event
earthquake-usgs-gov/earthquakes/event

What can you do with USGS earthquake details 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.

Questions about USGS earthquake details in Cursor

Can Cursor use USGS earthquake details?

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

How much does USGS earthquake details 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 details in Cursor?

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 Cursor?

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

Does Cursor wait while USGS earthquake details runs?

USGS earthquake details 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.

Get started

Start using USGS earthquake details in Cursor

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Cursor:

Set up Cursor

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options