Sentinel Hub MCP Server for Vercel AI SDKGive Vercel AI SDK instant access to 14 tools to Catalog Search, Check Sentinel Hub Status, Generate False Color Evalscript, and more
The Vercel AI SDK is the TypeScript toolkit for building AI-powered applications. Connect Sentinel Hub through Vinkius and every tool is available as a typed function. ready for React Server Components, API routes, or any Node.js backend.
Ask AI about this App Connector for Vercel AI SDK
The Sentinel Hub app connector for Vercel AI SDK 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
import { createMCPClient } from "@ai-sdk/mcp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
async function main() {
const mcpClient = await createMCPClient({
transport: {
type: "http",
// Your Vinkius token. get it at cloud.vinkius.com
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
});
try {
const tools = await mcpClient.tools();
const { text } = await generateText({
model: openai("gpt-4o"),
tools,
prompt: "Using Sentinel Hub, list all available capabilities.",
});
console.log(text);
} finally {
await mcpClient.close();
}
}
main();
* 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.
The Vercel AI SDK gives every Sentinel Hub tool full TypeScript type inference, IDE autocomplete, and compile-time error checking. Connect 14 tools through Vinkius and stream results progressively to React, Svelte, or Vue components. works on Edge Functions, Cloudflare Workers, and any Node.js runtime.
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 Vercel AI SDK 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 Vercel AI SDK
When Vercel AI SDK 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.
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
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
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
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
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 detailed information about a specific data collection
Use the item ID returned from a catalog_search query. Get detailed metadata for a specific STAC catalog item
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
Useful for verifying credentials and understanding available quotas. Get authenticated Sentinel Hub user profile information
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
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
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
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
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 Vercel AI SDK via MCP
Follow these steps to wire Sentinel Hub into Vercel AI SDK. The entire setup takes under two minutes — your credentials stay safe behind the Vinkius.
Install dependencies
npm install @ai-sdk/mcp ai @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the script
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Vercel AI SDK with the Sentinel Hub MCP Server
Vercel AI SDK provides unique advantages when paired with Sentinel Hub through the Model Context Protocol.
TypeScript-first: every MCP tool gets full type inference, IDE autocomplete, and compile-time error checking out of the box
Framework-agnostic core works with Next.js, Nuxt, SvelteKit, or any Node.js runtime. same Sentinel Hub integration everywhere
Built-in streaming UI primitives let you display Sentinel Hub tool results progressively in React, Svelte, or Vue components
Edge-compatible: the AI SDK runs on Vercel Edge Functions, Cloudflare Workers, and other edge runtimes for minimal latency
Sentinel Hub + Vercel AI SDK Use Cases
Practical scenarios where Vercel AI SDK combined with the Sentinel Hub MCP Server delivers measurable value.
AI-powered web apps: build dashboards that query Sentinel Hub in real-time and stream results to the UI with zero loading states
API backends: create serverless endpoints that orchestrate Sentinel Hub tools and return structured JSON responses to any frontend
Chatbots with tool use: embed Sentinel Hub capabilities into conversational interfaces with streaming responses and tool call visibility
Internal tools: build admin panels where team members interact with Sentinel Hub through natural language queries
Example Prompts for Sentinel Hub in Vercel AI SDK
Ready-to-use prompts you can give your Vercel AI SDK 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 Vercel AI SDK
Common issues when connecting Sentinel Hub to Vercel AI SDK through the Vinkius, and how to resolve them.
createMCPClient is not a function
npm install @ai-sdk/mcpSentinel Hub + Vercel AI SDK FAQ
Common questions about integrating Sentinel Hub MCP Server with Vercel AI SDK.
How does the Vercel AI SDK connect to MCP servers?
createMCPClient from @ai-sdk/mcp and pass the server URL. The SDK discovers all tools and provides typed TypeScript interfaces for each one.Can I use MCP tools in Edge Functions?
Does it support streaming tool results?
useChat and streamText that handle tool calls and display results progressively in the UI.