[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [USGS earthquake details](https://spiral.ai/integrations/muse-code/usgs-earthquake-details)

# How to Use USGS earthquake details in Muse 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.

|  |  |
| --- | --- |
| Model | USGS earthquake details |
| 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 details in Muse Code

- 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 Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse Code 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 details**: 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/event",
    "input": {
      "id": "<id>"
    }
  }'
```

Then paste one of the prompts above: Muse Code finds USGS earthquake details on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## USGS earthquake details tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| id |  | — | ComCat event id such as us6000jllz or official20110311054624120_30 (case-insensitive). Pass id or url, not both. Pattern: ^[A-Za-z0-9_-]{2,64}$. |
| url |  | — | USGS event page URL, https://earthquake.usgs.gov/earthquakes/eventpage/<id>[/...]. |

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

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Muse Code guides](https://spiral.ai/integrations/muse-code)

## USGS earthquake details in other agents

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

## More Muse Code guides

- [USDOT NAD release status](https://spiral.ai/integrations/muse-code/usdot-nad-release-status)
- [USGS earthquake search](https://spiral.ai/integrations/muse-code/usgs-earthquake-search)
- [USDOT NAD address points](https://spiral.ai/integrations/muse-code/usdot-nad-address-points)
- [V-Dem country coverage](https://spiral.ai/integrations/muse-code/v-dem-country-coverage)
- [UNESCO UIS statistical data](https://spiral.ai/integrations/muse-code/unesco-uis-statistical-data)
- [V-Dem dataset releases](https://spiral.ai/integrations/muse-code/v-dem-dataset-releases)

## Questions about USGS earthquake details in Muse Code

**Can Muse Code use USGS earthquake details?**

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

**How much does USGS earthquake details cost in Muse 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 Muse Code plan is separate.

**Do I need an Alexandria account to use USGS earthquake details in Muse 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 Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while USGS earthquake details runs?**

USGS earthquake details runs in the background. Muse 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.

