Bring Satellite Imagery
to Mastra AI

Accepts the same filter parameters as quick_search including geometry, date range, cloud cover, and item types. Returns a search ID that can be used with get_search_results to execute the search on demand. Essential for automated monitoring, change detection workflows, and recurring imagery retrieval. AI agents should use this when users ask "set up a search for new imagery over my field every week", "create a saved search for cloud-free images", or need to establish recurring imagery monitoring for a specific area. Create a saved search for continuous imagery monitoring

Accepts geometry, date range, cloud cover filters, item types, and delivery destination (cloud storage or webhook). Returns the created subscription with ID and status. Essential for setting up automated monitoring, establishing continuous data feeds for change detection, and ensuring regular imagery delivery for operational workflows. AI agents should use this when users ask "set up daily imagery delivery for my farm", "create a subscription for cloud-free images over this area", or need to establish automated imagery delivery for monitoring applications. Create a new subscription for continuous automated imagery delivery

Returns clear percentage, cloud percentage, and status information. Essential for quality assessment before downloading imagery, filtering cloudy images from analysis workflows, and ensuring usable imagery for visual interpretation. AI agents should use this when users ask "how cloudy is this image", "what percentage of this scene is clear", or need to assess imagery quality before committing to download. Estimate cloud coverage and clear area percentage for a specific imagery item

Each asset includes download URLs, file sizes, and permissions. Essential for selecting the appropriate data product for analysis, downloading imagery for GIS processing, and understanding available data products. AI agents should use this when users ask "what assets are available for this image", "get download URLs for analytic imagery", or need to select specific asset types (visual for display, analytic for analysis) for download. List all available asset types (visual, analytic, UDM) for a specific imagery item

Essential for evaluating image quality before download, understanding acquisition conditions, and preparing orders for specific imagery. AI agents should reference this when users ask "show me details for this image", "what is the cloud cover and acquisition time for item X", or need to evaluate imagery quality before downloading. Get detailed metadata for a specific satellite imagery item

Supports pagination (page, page_size) and sorting (acquired asc/desc, published asc/desc). Returns imagery items with acquisition dates, cloud cover, geometry, and available asset types. Essential for retrieving results from pre-configured monitoring searches and executing recurring imagery queries. AI agents should use this when users ask "run my Weekly Farm Monitoring search", "get results from saved search X", or need to execute a saved search and retrieve the latest imagery results. Execute a saved search and retrieve imagery results

Essential for understanding imagery availability patterns, planning data collection schedules, and assessing temporal coverage for change detection analysis. AI agents should use this when users ask "how many images are available per month for my area", "show me imagery availability statistics", or need to understand temporal patterns of satellite coverage before setting up monitoring. Get statistical histograms of available imagery for an area and time period

Returns asset type IDs, display names, and descriptions. Essential for selecting the appropriate data product for specific use cases (visual for visualization, analytic for NDVI calculation, UDM for quality filtering). AI agents should reference this when users ask "what asset types can I download", "difference between analytic and visual assets", or need to understand available data products for analysis. List all available asset types (visual, analytic, UDM, etc.) and their properties

Returns item type IDs, display names, and supported asset types for each. Essential for understanding available imagery sources, selecting appropriate resolution and coverage for analysis, and planning data acquisition strategies. AI agents should use this when users ask "what satellite imagery types are available", "compare PSScene vs SkySat resolution", or need to understand the full catalog of Planet imagery options. List all available satellite imagery item types and their supported assets

Returns search names, IDs, filter criteria, item types, and creation dates. Essential for managing monitoring workflows, reviewing existing search configurations, and selecting searches for execution. AI agents should reference this when users ask "show me all my saved searches", "list my monitoring configurations", or need to review existing saved searches before executing them. List all saved searches in your Planet account

Returns subscription names, IDs, filter criteria, delivery destinations, and status. Essential for monitoring automated imagery delivery, reviewing subscription configurations, and managing continuous data feeds. AI agents should reference this when users ask "show me all my subscriptions", "list automated imagery deliveries", or need to review existing subscription configurations. List all active imagery subscriptions for continuous cloud delivery

Supports item types including PSScene (PlanetScope, 3-5m resolution, daily global coverage), SkySat (sub-meter resolution, high-detail), RapidEye (5m resolution, historical archive), Landsat 8/9 (30m resolution, USGS), and Sentinel-2 (10m resolution, ESA). Returns imagery items with acquisition dates, cloud cover percentages, sun elevation, instrument mode, geometry, and available asset types. Essential for satellite imagery discovery, change detection analysis, disaster monitoring, and agricultural assessment. AI agents should use this when users ask "find cloud-free imagery over this area from last month", "search for PSScene images of my farm", or need to discover available satellite imagery for a specific location and time period. Geometry must be provided as GeoJSON (Point, Polygon, or MultiPolygon). Date filtering uses the acquired property in ISO 8601 format. Cloud cover and sun elevation are filtered using the filter object with range operators. Search for satellite imagery from Planet Labs with geometry, date, and cloud cover filters