How do I find my Upper API Token?

Log in to your account, navigate to **Settings** > **Web Service API**, and copy your unique high-fidelity **API Token**.

Can I check specific stop details via AI?

Yes! The `get_upper_stop_details` tool allows your agent to retrieve high-fidelity metadata including service time, customer contact, and delivery notes.

How do I list my optimized routes?

Use the `list_upper_routes` tool to retrieve the complete high-fidelity directory of routes along with their assigned drivers and status.

INSTANT PLUG AND PLAY

Upper Route Planner MCP Server for WindsurfGive Windsurf instant access to 6 tools to Check Upper Status, Create Upper Delivery Task, Get Upper Route Stop, and more

Name: Upper Route Planner
Availability: InStock
Author: Vinkius

Built by Vinkius GDPR 6 Tools IDE

Windsurf brings agentic AI coding to a purpose-built IDE. Connect Upper Route Planner 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 Upper Route Planner app connector for Windsurf is a standout in the Productivity category — giving your AI agent 6 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 Upper Route Planner and 3,400+ MCP Servers from a single visual interface.

Download Free Open SourceNo signup required

Classic Setup·json

{
  "mcpServers": {
    "upper-route-planner": {
      "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 Upper Route Planner MCP Server

Connect your Upper Route Planner account to any AI agent and take full control of your delivery logistics and high-fidelity route orchestration through natural conversation.

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

What you can do

Route Portfolio Orchestration — List all optimized delivery routes, retrieve detailed high-fidelity status metadata, and monitor route duration programmatically
Stop & Task Intelligence — Access your complete directory of high-fidelity route stops and tasks to stay on top of field delivery progress in real-time
Logistics Provisioning — Programmatically generate new high-fidelity delivery tasks with precise time windows and customer metadata directly through your agent
Driver Monitoring Architecture — Access high-fidelity driver assignments and resource allocation details to understand and orchestrate your field workforce
Stop Detail Discovery — Access complete high-fidelity metadata for specific delivery stops to maintain perfect contextual alignment for every parcel
Operational Monitoring — Verify account-level API connectivity and monitor route orchestration volume directly through your agent for perfectly coordinated service scaling

The Upper Route Planner MCP Server exposes 6 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 6 Upper Route Planner tools available for Windsurf

When Windsurf connects to Upper Route Planner through Vinkius, your AI agent gets direct access to every tool listed below — spanning route-optimization, delivery-management, fleet-tracking, 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.

check_upper_status

Check API Status

create_upper_delivery_task

Add a delivery task

get_upper_route_stop

Get specific route stop

get_upper_stop_details

Get stop details

list_upper_drivers

List delivery drivers

list_upper_routes

List delivery routes

Connect Upper Route Planner to Windsurf via MCP

Follow these steps to wire Upper Route Planner 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 Upper Route Planner

Open Cascade and ask: "Using Upper Route Planner, help me...". 6 tools available

Why Use Windsurf with the Upper Route Planner MCP Server

Windsurf provides unique advantages when paired with Upper Route Planner 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 6 tools are immediately available

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

Upper Route Planner + Windsurf Use Cases

Practical scenarios where Windsurf combined with the Upper Route Planner MCP Server delivers measurable value.

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

Live debugging: query Upper Route Planner tools mid-session to inspect production data while debugging without leaving the editor

Documentation generation: pull schema information from Upper Route Planner and have Cascade generate comprehensive API docs automatically

Rapid prototyping: combine Upper Route Planner data with Cascade's code generation to scaffold entire features in minutes

Example Prompts for Upper Route Planner in Windsurf

Ready-to-use prompts you can give your Windsurf agent to start working with Upper Route Planner immediately.

"List all delivery routes scheduled for today."

"Create a new delivery task for '123 Tech St' with contact 'John Doe'."

"Check the status of route stop 'stop_456'."

Troubleshooting Upper Route Planner MCP Server with Windsurf

Common issues when connecting Upper Route Planner 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.

Upper Route Planner + Windsurf FAQ

Common questions about integrating Upper Route Planner 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.