What is an evalscript and how do I use one?

An evalscript is a small JavaScript program that tells Sentinel Hub how to process satellite bands into an output image. It defines which bands to use, how to combine them, and what colors to assign. You can use the generate_ndvi_evalscript or generate_true_color_evalscript tools to get ready-made evalscripts, then pass them to the process_image tool.

Can I analyze vegetation health with this server?

Absolutely. Generate an NDVI evalscript with the generate_ndvi_evalscript tool, then process imagery for your area of interest with the process_image tool. For time-series analysis, use the get_statistics tool with temporal aggregation to track vegetation changes over weeks or months. The search_cloud_free tool helps you find clean scenes without cloud contamination.

What is the difference between this server and the Copernicus Data Space server?

The Copernicus Data Space server focuses on product catalogue search and download — finding and retrieving raw satellite data files. Sentinel Hub focuses on on-the-fly processing — rendering images, computing indices, and generating statistics without downloading raw data. They complement each other: use Copernicus for data discovery and bulk download, Sentinel Hub for real-time analysis and visualization.

INSTANT PLUG AND PLAY

Sentinel Hub MCP Server for WindsurfGive Windsurf instant access to 14 tools to Catalog Search, Check Sentinel Hub Status, Generate False Color Evalscript, and more

Name: Sentinel Hub
Availability: InStock
Author: Vinkius

Built by Vinkius GDPR 14 Tools IDE

Windsurf brings agentic AI coding to a purpose-built IDE. Connect Sentinel Hub through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.

Use with Your AI Agent

Ask AI about this App Connector for Windsurf

Open in ChatGPT Open in Claude Open in Perplexity

The Sentinel Hub app connector for Windsurf is a standout in the Cloud Infrastructure category — giving your AI agent 14 tools to work with, ready to go from day one.

Vinkius delivers Streamable HTTP and SSE to any MCP client

RecommendedModern Approach — Zero Configuration

Vinkius Desktop App

The modern way to manage MCP Servers — no config files, no terminal commands. Install Sentinel Hub and 3,400+ MCP Servers from a single visual interface.

Download Free Open SourceNo signup required

Classic Setup·json

{
  "mcpServers": {
    "sentinel-hub": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Sentinel Hub MCP Server

Connect to Sentinel Hub — the most powerful satellite imagery processing API in Europe — and transform raw Earth observation data into actionable intelligence.

Windsurf's Cascade agent chains multiple Sentinel Hub tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 14 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.

What you can do

STAC Catalog Search — Discover available satellite scenes by location, date, collection, cloud cover, and MGRS tile ID across all Sentinel missions and Landsat
Image Processing — Render custom satellite imagery using evalscripts (JavaScript-based processing scripts) that define how bands are combined, indices are calculated, and pixels are colored
Vegetation Analysis (NDVI) — Generate ready-to-use NDVI evalscripts that color-code vegetation density from bare soil to dense forest
Statistical Analysis — Calculate mean, min, max, standard deviation, and histograms over areas of interest with temporal aggregation (daily, weekly, monthly)
Cloud-Free Search — Find satellite scenes below a specified cloud cover threshold for clean optical analysis
Band Combinations — Access a curated library of 10 predefined band combinations including True Color, False Color, NDWI, Moisture Index, SWIR, and Burn Severity

The Sentinel Hub MCP Server exposes 14 tools through the Vinkius. Connect it to Windsurf in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

All 14 Sentinel Hub tools available for Windsurf

When Windsurf connects to Sentinel Hub through Vinkius, your AI agent gets direct access to every tool listed below — spanning satellite-imagery, earth-observation, geospatial-data, and more. Every call is secured with network, filesystem, subprocess, and code evaluation entitlements inside a sandboxed runtime. Beyond a simple connection, you get a full AI Gateway with real-time visibility into agent activity, enterprise governance, and optimized token usage.

catalog_search

Specify a collection ID (e.g., "sentinel-2-l2a", "sentinel-1-grd"), a bounding box as [west, south, east, north] coordinates, and a date range. Returns item metadata including geometry, cloud cover, and band information. Search the Sentinel Hub STAC catalog for satellite imagery

check_sentinel_hub_status

Returns the connection status and service URL. Use this to verify your client_id:client_secret credentials are working correctly. Verify Sentinel Hub API connectivity and authentication

generate_false_color_evalscript

In the output, healthy vegetation appears bright red, urban areas appear cyan/grey, and water appears dark blue. This is the standard false-color composite used in remote sensing for vegetation mapping and land cover classification. Generate a false-color evalscript for vegetation emphasis

generate_ndvi_evalscript

The output is color-coded: dark for water/shadow, grey for bare soil, yellow-green for sparse vegetation, and deep green for dense vegetation. Use the returned evalscript with the process_image tool. Generate a ready-to-use NDVI evalscript for vegetation analysis

generate_true_color_evalscript

Use the returned evalscript with the process_image tool to get visually appealing satellite photos of any location on Earth. Generate a true-color RGB evalscript for natural imagery

get_catalog_collection

Get detailed information about a specific data collection

get_catalog_item

Use the item ID returned from a catalog_search query. Get detailed metadata for a specific STAC catalog item

get_statistics

Requires an evalscript that defines which bands to analyze. Supports temporal aggregation (daily, weekly, monthly) for time-series analysis of vegetation indices, water levels, or urban expansion. Calculate statistics over an area from satellite imagery

get_user_info

Useful for verifying credentials and understanding available quotas. Get authenticated Sentinel Hub user profile information

list_band_combinations

Includes True Color, False Color (vegetation), NDVI, NDWI, Moisture Index, SWIR, SAR polarizations, Scene Classification, and Burn Severity (NBR). Each entry specifies the required bands and target collection. List predefined satellite band combinations and indices

list_catalog_collections

Includes Sentinel-1 GRD (radar), Sentinel-2 L1C/L2A (optical), Sentinel-3 OLCI/SLSTR, Sentinel-5P (atmosphere), Landsat 8-9, DEM, and Copernicus Land Monitoring Service data. List all available Sentinel Hub satellite data collections

process_image

Specify the data collection, area of interest as a bounding box, date range, and the evalscript. The evalscript defines band inputs, processing logic, and output format. Use generate_ndvi_evalscript or generate_true_color_evalscript tools to get ready-made evalscripts. Process satellite imagery with a custom evalscript

search_by_tile

MGRS tiles are the standard spatial reference for Sentinel-2 data (e.g., "33UUP" for central Europe, "29SQB" for Lisbon area). Returns all scenes for the specified tile within the date range. Search Sentinel-2 imagery by MGRS tile identifier

search_cloud_free

Essential for optical analysis where cloud contamination would corrupt results. Typical thresholds: <10% for clean analysis, <30% for general use, <50% for temporal coverage. Search for cloud-free satellite imagery below a threshold

Connect Sentinel Hub to Windsurf via MCP

Follow these steps to wire Sentinel Hub into Windsurf. The entire setup takes under two minutes — your credentials stay safe behind the Vinkius.

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"

Add the server

Paste the JSON configuration above into mcp_config.json

Save and reload

Windsurf will detect the new server automatically

Start using Sentinel Hub

Open Cascade and ask: "Using Sentinel Hub, help me...". 14 tools available

Why Use Windsurf with the Sentinel Hub MCP Server

Windsurf provides unique advantages when paired with Sentinel Hub through the Model Context Protocol.

Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention

Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively

JSON-based configuration means zero code changes: paste a URL, reload, and all 14 tools are immediately available

Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts

Sentinel Hub + Windsurf Use Cases

Practical scenarios where Windsurf combined with the Sentinel Hub MCP Server delivers measurable value.

Automated code generation: ask Cascade to fetch data from Sentinel Hub and generate models, types, or handlers based on real API responses

Live debugging: query Sentinel Hub tools mid-session to inspect production data while debugging without leaving the editor

Documentation generation: pull schema information from Sentinel Hub and have Cascade generate comprehensive API docs automatically

Rapid prototyping: combine Sentinel Hub data with Cascade's code generation to scaffold entire features in minutes

Example Prompts for Sentinel Hub in Windsurf

Ready-to-use prompts you can give your Windsurf agent to start working with Sentinel Hub immediately.

"Show me an NDVI vegetation analysis for the Amazon rainforest region."

"Find cloud-free Sentinel-2 imagery over Paris with less than 10% clouds."

"What band combinations can I use for wildfire assessment?"

Troubleshooting Sentinel Hub MCP Server with Windsurf

Common issues when connecting Sentinel Hub to Windsurf through the Vinkius, and how to resolve them.

Server not connecting

Check Settings → MCP for the server status. Try toggling it off and on.

Sentinel Hub + Windsurf FAQ

Common questions about integrating Sentinel Hub MCP Server with Windsurf.

How does Windsurf discover MCP tools?

Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.

Can Cascade chain multiple MCP tool calls?

Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.

Does Windsurf support multiple MCP servers?

Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.