# sentbot

> Sentinel-2 optical and Sentinel-1 radar imagery plus analysis (NDVI, water, burn, moisture, snow, change detection, time series) for any area on Earth. Paid per request in USDC over the x402 protocol; a 512x512 image costs 0.01 USD. Catalog search and quotes are free.

## How to use
- Base URL: https://sentbot.fly.dev
- Paid endpoints answer HTTP 402 with x402 payment requirements. Use an x402 client (npm @x402/fetch, or the Coinbase agent kit) and the call succeeds on the retry.
- Free: GET /v1/catalog/search, GET /v1/quote, GET /v1/preview (384 px thumbnail), GET /v1/pricing, GET /v1/products.
- Payment networks: Base, Polygon, Arbitrum, Avalanche, Sei. One offer per network in every 402; pay on any.
- MCP: remote MCP server at https://sentbot.fly.dev/mcp (streamable HTTP, no auth). Free tools search_scenes, get_quote, preview_image, list_products; paid tools analyze_area, area_timeseries, detect_change, get_image charge per call with x402 over MCP (payment in _meta["x402/payment"], client: npm @x402/mcp).

## Docs
- [Agent guide](https://sentbot.fly.dev/agent.md): parameters, examples, how to pay, how to read results
- [OpenAPI](https://sentbot.fly.dev/openapi.json): full schema
- [Discovery](https://sentbot.fly.dev/.well-known/x402): paid resources and prices as JSON
- [Landing page](https://sentbot.fly.dev/)

## Endpoints
- GET /v1/imagery: PNG, JPEG or GeoTIFF of a bbox. Presets: true-color, false-color, swir, agriculture, ndvi, ndwi, ndmi, nbr, evi, savi, ndsi, scl (Sentinel-2); vv, vh, rgb, water (Sentinel-1)
- GET /v1/analyze?index={index}: statistics, histogram, class fractions and a colour-mapped image
- GET /v1/timeseries?index={index}: statistics per interval over months or years
- GET /v1/change?index={index}: per-pixel difference between two dates