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/fishing — USGS water-quality conditions (temp, dissolved oxygen, pH, turbidity) for nearby fishing waters
/api/tropics — active Atlantic tropical cyclones from the NOAA NHC (empty when the basin is quiet)
/api/pollen — the Houston Health Department's measured daily pollen and mold count (weekday mornings)
/api/air — the measured US AQI (EPA/AirNow, Houston metro area) with a per-pollutant breakdown
/api/traffic — incidents and lane closures on Crosby's roads, from Houston TranStar
/api/news — recent local Crosby-area headlines
/api/calendar — upcoming Crosby ISD school events
/api/health — site liveness, when each feed last tried to refresh and whether it worked, and when its data last actually changed

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. Every content page supports it, in both languages, including this one and the MCP explainer.

/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_tropical_outlook, get_pollen, get_air_quality, get_river_levels, get_fishing, get_traffic, get_crosby_news, get_school_events, get_emergency_contacts, and get_radar (a live radar image, inline) — 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 (also in Spanish at /es/mcp)
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)

Embeddable weather badge

Put live Crosby weather on your own site with one image tag — a small SVG (300×80) showing the current temperature, conditions, feels-like, and an alert flag. Edge-cached and refreshed on the same 15-minute cycle as everything else; no key, no script, CORS open.

/badge.svg — the live badge — embed with <img src="https://crosbynews.com/badge.svg" width="300" height="80" alt="Crosby, TX weather">

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.