How to Use the Nearmap (High-Res Aerial Imagery & AI) MCP in Windsurf

Q: Does Cascade handle the zoom parameters for map tiles automatically?

It does. When invoking tools like getverticaltile or getdsmelevationtile, the agent calculates the correct x, y, and z zoom levels based on the bounding box you specify.

Give Cascade the eyes to see the physical world. Pull high-res aerial tiles and AI feature layers directly into Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nearmap (High-Res Aerial Imagery & AI) MCP to Windsurf

Create your Vinkius account to connect Nearmap (High-Res Aerial Imagery & AI) to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Nearmap (High-Res Aerial Imagery & AI) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-Step Geospatial Analysis in Windsurf

Cascade doesn't just pull a single image. You give it a coordinate, and it chains the necessary tools to build a complete site profile. It starts by hitting `list_survey_dates` to find the most recent capture, then automatically pulls the `get_vertical_tile` to give you the visual context right in your IDE. It doesn't stop there. Without waiting for a second prompt, Cascade can run `get_ai_detected_features` to extract vector geometries for buildings, pools, and solar panels. You just ask for a property breakdown, and Windsurf handles the entire API sequence.

Topographic and 3D Context (MCP Server)

Flat maps only tell half the story. This MCP Server lets your agent pull complex elevation data using the `get_dsm_elevation_tile` tool, giving you digital surface models that map building peak heights and terrain changes. When you need to understand the side profile of a structure, Cascade grabs a `get_oblique_tile` looking North, South, East, or West. It pieces together the 3D perspective so you can evaluate structural targets without leaving your editor.

Automated Survey Coverage Audits

Before you try to pull heavy imagery payloads, you need to know if the data actually exists. Windsurf can run a `check_coverage_polygon` to verify internal aerial survey boundaries across your mapped target zones. If you are working with a specific point instead, it uses `check_coverage_point`. Cascade checks the temporal history arrays and pulls the optical flight details via `get_survey_metadata` so you know exactly what resolution you are dealing with before writing a single line of code.

Setup guide

Set up Nearmap (High-Res Aerial Imagery & AI) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Nearmap (High-Res Aerial Imagery & AI) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Nearmap (High-Res Aerial Imagery & AI) payment history." If connected, Cascade will call the Nearmap (High-Res Aerial Imagery & AI) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "nearmap-high-res-aerial-imagery-ai-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Nearmap. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Nearmap (High-Res Aerial Imagery & AI) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Nearmap (High-Res Aerial Imagery & AI) MCP in Windsurf

Open your settings and navigate to the Cascade MCP Servers UI. You can add the server configuration directly to your mcp_config.json file. Hit refresh in the MCP panel and Cascade will auto-discover the tools.

Yes. Cascade excels at this. If you ask for a property analysis, it will run `list_survey_dates` and then immediately pass those parameters into `get_true_ortho_tile` without needing a second prompt.

You can pull building footprints, vegetation bounds, and solar panel locations. Run the `list_ai_feature_classes` tool to see the exact computer vision taxonomies available for your target coordinates.

It does. When invoking tools like `get_vertical_tile` or `get_dsm_elevation_tile`, the agent calculates the correct x, y, and z zoom levels based on the bounding box you specify.

Vinkius runs this integration inside an ephemeral V8 Isolate Sandbox. When you query exact latitude and longitude coordinates or vector geometries, that location data passes through a zero-trust environment. Nothing gets logged or cached after the request completes.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript