Pull species phenophase onset dates from the USA-NPN Observational Data API to time pruning or pest treatments
domain: usanpn.org · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Review USA-NPN's published Observational Data API documentation (linked from usanpn.org/data/code) to identify the individual- or site-phenometrics service you need.
Always populate the request_source parameter with your name or organization — USA-NPN uses an honor-system identification requirement instead of API keys.
Query by species_id (from USA-NPN's species list) and a date/year range to retrieve phenophase onset/end estimates (e.g. leaf-out, flowering, dormancy) relevant to pruning or pest-treatment windows.
For raster/gridded products (e.g. spring-onset anomaly maps) instead of point observations, use the separate Geoserver Request Builder at data.usanpn.org/geoserver-request-builder.
Reference the maintained rnpn R client's documented call patterns as an implementation guide if you're building a custom HTTP client in another language.
Known gotchas
No API key is required, but request_source is treated as a required parameter on relevant calls — omitting it can cause the request to be rejected, not just logged.
Observational (point) data and geospatial (gridded/raster) data are two separate APIs with different access patterns and documentation — one endpoint does not cover both.
USA-NPN data is crowdsourced (Nature's Notebook observers) and model-driven for gridded products; neither is a guarantee for a specific property, so treat it as regional guidance for treatment timing rather than a precise on-site forecast.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?