Sentinel Hub MCP Server for Mastra AIGive Mastra AI instant access to 14 tools to Catalog Search, Check Sentinel Hub Status, Generate False Color Evalscript, and more
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Sentinel Hub through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this App Connector for Mastra AI
The Sentinel Hub app connector for Mastra AI 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 { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"sentinel-hub": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Sentinel Hub Agent",
instructions:
"You help users interact with Sentinel Hub " +
"using 14 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Sentinel Hub?"
);
console.log(result.text);
}
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.
Mastra's agent abstraction provides a clean separation between LLM logic and Sentinel Hub tool infrastructure. Connect 14 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
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 Mastra AI 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 Mastra AI
When Mastra AI 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 Mastra AI via MCP
Follow these steps to wire Sentinel Hub into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind the Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Sentinel Hub MCP Server
Mastra AI provides unique advantages when paired with Sentinel Hub through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Sentinel Hub without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Sentinel Hub tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Sentinel Hub + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Sentinel Hub MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Sentinel Hub, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Sentinel Hub as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Sentinel Hub on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Sentinel Hub tools alongside other MCP servers
Example Prompts for Sentinel Hub in Mastra AI
Ready-to-use prompts you can give your Mastra AI 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 Mastra AI
Common issues when connecting Sentinel Hub to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpSentinel Hub + Mastra AI FAQ
Common questions about integrating Sentinel Hub MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.