Resources and prompts¶

Resources¶

Static guides are cached by clients for 24 hours, derived references for one hour (ttlMs on each read; cacheScope is always public)¹.

URI	Kind	Content
`neon://guide/agent-workflow`	static	The five-call recipe (search → availability → files → download → cite), input rules, error remedies
`neon://guide/api-token`	static	Which endpoints need a token, how to set it, rate limits
`neon://guide/citing-neon-data`	static	Data policy and the citation templates `neon_get_citation` renders
`neon://guide/product-code-anatomy`	static	Product codes, packages, the file-name grammar, releases and PROVISIONAL
`neon://reference/vocabularies`	static	Valid filter values: themes, teams, domains, taxon types, location types, releases, file kinds
`neon://reference/graphql-schema`	static	Root fields, inputs and object fields for `neon_graphql`
`neon://reference/sites`	derived	All 81 field sites with codes, names, domains, states and coordinates
`neon://reference/releases`	derived	Every release with its date and product count, plus the latest tag

Template	Reads as
`neon://products/{productCode}`	the `neon_get_product` result
`neon://sites/{siteCode}`	the `neon_get_site` result (with products)
`neon://releases/{release}`	the `neon_get_release` result

An unknown URI is a JSON-RPC -32602 error with data.code = "not_found" and data.didYouMean.

Prompt	Arguments	Steers the agent to
`neon_find_data`	`question` (required), `region`, `timeframe`, `organism_or_variable`	search products and sites, check availability, size the data (with a token) and cite
`neon_cite_dataset`	`product` (required), `release`, `site_codes`	produce citation text and BibTeX, with the provisional caveat when needed
`neon_plan_download`	`product`, `sites`, `start_month` (required), `end_month`, `package`	check the token, availability and size, then download (stdio) or hand back URLs, and cite