[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [NOAA annual storm records](https://spiral.ai/integrations/opencode/noaa-annual-storm-records)

# How to Use NOAA annual storm records in opencode

Returns rows from one year’s event details, locations, or fatalities file. Use it to build county summaries, compare reported impacts, or collect records for local filtering.

|  |  |
| --- | --- |
| Model | NOAA annual storm records |
| 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 NOAA annual storm records in opencode

- Use NOAA annual storm records for 2023 to build a Florida event table in this project, with dates, event types, reported damage, and event IDs.
- Use NOAA annual storm records for 2013 to create a map dataset of Oklahoma event location points, retaining event IDs for joins.
- Use NOAA annual storm records to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from NOAA annual storm records and tell me what changed since last week.
- Check NOAA annual storm records and summarize what you find in three bullet points.

## How to set up NOAA annual storm records in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 NOAA annual storm records**: 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": "ncei-noaa-gov/storm-events/records_list",
    "input": {
      "type": "details"
    }
  }'
```

Then paste one of the prompts above: opencode finds NOAA annual storm records on Spiral, shows the price and runs it.

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

## NOAA annual storm records tools and prices

- [NOAA NCEI Storm Events Database bulk CSVs · Records list](https://spiral.ai/tools/alexandria/ncei-noaa-gov/storm-events/records_list) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| type | details, locations, fatalities | — | Required without a cursor. |
| year | 1950 to 2100 | — | Data year (the `d` part of the file name), 1950 to the current year. |
| cursor |  | — | `next_cursor` of the previous page; carries the segment, so type and year may be omitted (if given they must match). |
| page_size | 1 to 2000 | 2000 | Rows per page, at most 2000. |

## What can you do with NOAA annual storm records in opencode?

Build a county storm-history report from NOAA's annual files and individual event records. A coding agent can add publication checks so the project's reports can be refreshed when NOAA changes a file.

### County storm-history brief

Collect annual records for Harris County, Texas, examine selected events for narrative context, and check publication versions before refreshing the brief.

### Historical event case study

Find records for the May 20, 2013, Moore, Oklahoma, tornado, examine the associated event details and location points, and identify the publication used for the study.

### Reported damage comparison

Compare reported property and crop damage across years in Iowa, read the narratives behind selected events, and refresh calculations when NOAA revises the underlying files.

### Storm location map

Build a map of published event points for Oklahoma in 2013, add event narratives to selected map entries, and check whether the source publications have changed.

### Revision review

Detect a changed annual publication, compare its records with a saved copy, and inspect the details of events whose reported impacts changed.

### Public storm archive

Create a searchable historical collection for Florida using annual records, event detail pages, and publication checks that identify when the collection needs refreshing.

## Overview

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

## NOAA annual storm records in other agents

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

## More opencode guides

- [NHTSA vehicle search](https://spiral.ai/integrations/opencode/nhtsa-vehicle-search)
- [NOAA storm data publication status](https://spiral.ai/integrations/opencode/noaa-storm-data-publication-status)
- [NHTSA vehicle safety ratings](https://spiral.ai/integrations/opencode/nhtsa-vehicle-safety-ratings)
- [NOAA storm event details](https://spiral.ai/integrations/opencode/noaa-storm-event-details)
- [NHTSA vehicle recalls](https://spiral.ai/integrations/opencode/nhtsa-vehicle-recalls)
- [New Hampshire bill details](https://spiral.ai/integrations/opencode/new-hampshire-bill-details)

## Questions about NOAA annual storm records in opencode

**Can opencode use NOAA annual storm records?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run NOAA annual storm records like any built-in tool.

**How much does NOAA annual storm records cost in opencode?**

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

**Do I need an Alexandria account to use NOAA annual storm records in opencode?**

No. Spiral runs NOAA annual storm records on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up NOAA annual storm records in opencode?**

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

**Does opencode wait while NOAA annual storm records runs?**

NOAA annual storm records runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**What geographic area does NOAA Storm Events cover?**

It covers significant weather in the United States and adjacent water bodies. It is a regional storm archive, so it cannot supply a worldwide event history.

**How far back do the records go?**

The database begins in January 1950. That starting date describes the archive as a whole, rather than establishing complete coverage for every hazard throughout the period.

**How soon do recent storms appear?**

NOAA documents a delay of 75 to 90 days after the end of a data month. Its bulk-download documentation specifies monthly updates to the current yearly file and allows corrections to previous years.

**Why are details, locations, and fatalities separate?**

NOAA publishes three files linked by event ID. Details describe the event, locations provide indexed geographic points, and fatalities contain the associated fatality records.

**How accurate are the reported impacts?**

Property and crop damage are estimates. NOAA also cautions that outside reports may be unverified and that NWS does not guarantee the accuracy or validity of Storm Data.

