Developers & Agents

crosbynews.com is built to be read by machines as well as people. Everything below is public and free, with no API key or sign-up. Source data is U.S. government public domain (NWS/NOAA) — attribute it as "U.S. National Weather Service."

JSON API

Every dataset behind the site is a plain JSON endpoint with open CORS (Access-Control-Allow-Origin: *) and no rate limits. The polled endpoints also support conditional GET (ETag / If-None-Match → 304):

/api/weather — current conditions, hourly, 7-day forecast, alerts, plus feels-like and sun times
/api/water — river/bayou stage, flow, and NWS flood stages
/api/news — recent local Crosby-area headlines
/api/calendar — upcoming Crosby ISD school events
/api/health — service status and cache freshness

Specs & discovery

Machine-readable descriptions and a discovery catalog:

/openapi.json — OpenAPI 3.1 description of every endpoint
/.well-known/api-catalog — RFC 9727 API catalog (linkset)

Markdown for every page

Any page returns clean Markdown instead of HTML when you send an Accept: text/markdown header or append ?format=md — handy for LLMs and text pipelines. The forecast, hub, water, news, alerts, and calendar pages all support it.

/weather?format=md — the forecast, rendered as Markdown
/llms.txt — plain-language site summary for LLMs (llmstxt.org)

MCP server

A stateless Model Context Protocol server (Streamable HTTP, JSON-RPC) exposes the data as callable tools — get_current_conditions, get_forecast, get_alerts, get_river_levels, get_crosby_news, get_school_events — plus a crosby_briefing prompt and readable resources.

Connect from Claude Code: claude mcp add --transport http crosbynews https://crosbynews.com/mcp

/mcp — MCP endpoint (POST JSON-RPC); a GET shows a human explainer
MCP server card — discovery metadata

Agent skills

An agentskills.io (v0.2.0) discovery index points to a real SKILL.md for the Crosby weather data; its digest is a runtime hash of the file, so the two can't drift.

/.well-known/agent-skills/index.json — agent-skills discovery index

RSS feeds

Watch alerts and local news in any feed reader — the no-account, no-tracking notification channel:

/alerts.xml — active NWS alerts (RSS 2.0; empty when all clear)
/news.xml — curated Crosby-area headlines (RSS 2.0)

Terms & attribution

Public and unauthenticated, no rate limits — please be reasonable with polling (the data refreshes every 15 minutes). Weather and water data are U.S. government public domain from the National Weather Service and NOAA; news headlines link to their original publishers.

crosbynews.com is an independent project and is not affiliated with the National Weather Service, NOAA, Crosby ISD, or any government agency.