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

Windsurf · Listings

How to Use NWS weather stations in Windsurf

Returns weather station information for finding nearby reporting sites or resolving station identifiers. Use it to choose the station behind a current-conditions check or recent observation review.

Prompts to try with NWS weather stations in Windsurf

Copy an example into Windsurf, or ask in your own words.

Use NWS weather stations around the Washington Monument at 38.8894, -77.0352 and add a station selector using the returned identifiers.

NWS weather stationsWindsurf
Try asking
  • Use NWS weather stations to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from NWS weather stations and tell me what changed since last week.

  • Check NWS weather stations and summarize what you find in three bullet points.

  • Pull the newest data from NWS weather stations and give me the result as a table.

How to set up NWS weather stations in Windsurf

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

Use Spiral's MCP server

  1. Add the server

    Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:

    {
      "mcpServers": {
        "spiral": {
          "url": "https://api.spiral.ai/mcp"
        }
      }
    }
  2. Sign in

    Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf 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 NWS weather stations

    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": "api-weather-gov/weather/stations",
        "input": {
          "ids": [
            "<ids>"
          ]
        }
      }'

Then paste one of the prompts above: Windsurf finds NWS weather stations on Spiral, shows the price and runs it.

NWS weather stations providers and prices

Spiral runs NWS weather stations through Alexandria. Open a card for today's price, with every fee included.

AlexandriaListings

Settings you can ask for

Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Limit1 to 500100

Stations per page (state mode) or at most this many nearest stations (geometry mode).

Every API field of National Weather Service API (api.weather.gov) · Stations is on its tool page: open its card above.

What can you do with NWS weather stations in Windsurf?

Build a facility weather view that puts NWS forecasts, station reports, and official alerts beside operational decisions. A coding agent can add the returned data to your project while keeping forecast grid cells, reporting stations, and alert areas distinct.

Stadium operations briefing

Build a weather briefing for Nissan Stadium in Nashville: identify reporting stations, compare recent and latest readings, review daily and hourly forecasts, and summarize current and recent alerts with their full official messages.

Construction shift planning

Prepare a site briefing that pairs the coming days and working hours with current station conditions. Identify the reporting station, review the past week's readings and alerts, and include official alert text when explaining possible work interruptions.

Public park maintenance schedule

Help a park supervisor compare maintenance days and hourly work windows. Include nearby station information, recent and latest observations, and current and recent hazard messages so the schedule has both an outlook and recent weather context.

Commercial nursery weather board

Create a nursery's daily weather board with a station directory, recent and latest readings, daily outlooks, and hourly conditions. Add current alerts and the past week's alert timeline, opening the official message for hazards relevant to outdoor operations.

Recent storm disruption review

Reconstruct the last few days around a facility disruption using station readings and the NWS alert timeline. Read the full warning messages to distinguish a warning being issued from weather actually measured at a station.

Questions about NWS weather stations in Windsurf

Can Windsurf use NWS weather stations?

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run NWS weather stations like any built-in tool.

How much does NWS weather stations cost in Windsurf?

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

Do I need an Alexandria account to use NWS weather stations in Windsurf?

No. Spiral runs NWS weather stations on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up NWS weather stations in Windsurf?

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

Does Windsurf wait while NWS weather stations runs?

NWS weather stations runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

How far ahead and back does NWS weather data go?

NWS forecast products cover the next seven days. Its API retains seven days of station observations and seven days of recent alerts, so it is intended for current operations and recent-event reviews.

Does the latest observation mean conditions this minute?

NWS says observations may arrive up to 20 minutes late because its upstream MADIS source performs quality checks. The latest available station report can therefore describe earlier conditions.

How local is NWS weather data?

Forecasts use grid squares about 2.5 kilometers across, while observations describe individual reporting stations. Alerts can cover warning polygons, counties, or forecast zones, so these products have different geographic footprints.

Does NWS include every emergency alert?

NWS CAP does not include all non-weather emergency alerts. NWS directs users seeking comprehensive weather and non-weather emergency messages to FEMA IPAWS.

Can NWS information be copied into a report or application?

NWS describes its published information as public information that may be distributed or copied, and requests appropriate credits. Its CAP messages have a specific restriction: they must not be used to activate Emergency Alert System equipment.

Get started

Start using NWS weather stations in Windsurf

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

Paste this into Windsurf:

Set up Windsurf

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