
Mapbox Geospatial Operations
Choose the right Mapbox MCP geospatial tools—isochrone, point-in-polygon, optimization, matrix, directions—for delivery zones and routing problems.
Overview
mapbox-geospatial-operations is an agent skill most often used in Build (also Validate prototype, Grow analytics) that picks efficient Mapbox MCP tools for zones, routing, and multi-stop optimization.
Install
npx skills add https://github.com/mapbox/mapbox-agent-skills --skill mapbox-geospatial-operationsWhat is this skill?
- Hybrid isochrone plus point-in-polygon for bulk address checks inside a drive-time zone
- optimization_tool for multi-stop TSP-style reordering versus directions_tool or matrix_tool
- Eval-driven guidance: avoid N-times directions calls when geometry suffices
- E-commerce and logistics scenarios: warehouses, depots, delivery SLAs
- Distinguishes travel-time matrices from full route optimization workflows
- Eval scenario: 500 customer addresses checked against one 30-minute isochrone zone
- Eval scenario: 8 delivery stops optimized from an NYC depot
Adoption & trust: 1.1k installs on skills.sh; 64 GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You have addresses and time budgets but are unsure which Mapbox MCP tools to combine without burning API calls on repeated directions requests.
Who is it for?
Indie SaaS or commerce builders prototyping delivery zones, route optimization, or agent-driven logistics with Mapbox MCP.
Skip if: Pure map styling or GL JS UI work with no routing API decisions, or teams without Mapbox MCP access.
When should I use this skill?
User designs delivery zones, multi-stop routing, or bulk geospatial checks with Mapbox MCP tools and needs efficient isochrone, polygon, optimization, matrix, or directions selection.
What do I get? / Deliverables
You get a concrete tool chain—isochrone, polygon checks, optimization, matrix, or directions—matched to scale and whether stops must be reordered.
- Recommended Mapbox MCP tool sequence for the stated logistics problem
- Rationale avoiding redundant directions_tool calls at scale
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Mapbox MCP tool selection is primarily an integrations build task when wiring location features into a product. Geospatial APIs and MCP orchestration live under integrations—connecting routing, zones, and optimization to app logic.
Where it fits
Scope a 30-minute delivery MVP by modeling one isochrone zone instead of per-address directions in a spike.
Wire optimization_tool output into your dispatch service after choosing it over naive directions_tool loops.
Explain to stakeholders why batch polygon checks scale better than 500 directions API calls for zone membership reports.
How it compares
Skill package for MCP geospatial orchestration—not a replacement for Mapbox account setup or map rendering tutorials.
Common Questions / FAQ
Who is mapbox-geospatial-operations for?
Solo builders and small teams shipping location-aware apps who need agent guidance on Mapbox MCP isochrone, polygon, optimization, matrix, and directions tools.
When should I use mapbox-geospatial-operations?
Use it in Build integrations when designing delivery-zone checks or fleet routing; in Validate prototype when scoping a 30-minute radius MVP; in Grow analytics when explaining efficient geospatial batch patterns to ops stakeholders.
Is mapbox-geospatial-operations safe to install?
It documents third-party Mapbox MCP usage; confirm tokens, billing, and data handling in your environment and review the Security Audits panel on this page.
SKILL.md
READMESKILL.md - Mapbox Geospatial Operations
{ "skill_name": "mapbox-geospatial-operations", "evals": [ { "id": 1, "prompt": "We're an e-commerce company with a warehouse in Austin, TX (30.2672° N, 97.7431° W). We have a list of 500 customer addresses and we want to know which ones are within our 30-minute delivery zone. What's the most efficient approach using the Mapbox MCP tools?", "expected_output": "Should recommend a two-step hybrid approach: (1) use isochrone_tool to create the 30-minute driving zone once, then (2) use point_in_polygon_tool to check each of the 500 addresses against that zone geometrically. Should NOT suggest calling directions_tool 500 times.", "files": [], "expectations": [ "Recommends isochrone_tool to generate the 30-minute travel-time zone", "Recommends point_in_polygon_tool for checking addresses against the zone", "Does NOT suggest calling directions_tool 500 times", "Explains why this hybrid approach is efficient (routing for zone creation, geometric for containment checks)" ] }, { "id": 2, "prompt": "I have 8 delivery stops today starting from our depot at 40.7128° N, 74.0060° W in New York City. I want to minimize total drive time. Which Mapbox MCP tool should I use?", "expected_output": "Should recommend optimization_tool for multi-stop route optimization (TSP solver). Should distinguish it from directions_tool (which doesn't reorder stops) and matrix_tool (which only gives travel times, not optimal ordering).", "files": [], "expectations": [ "Recommends optimization_tool as the primary tool", "Explains that optimization_tool solves the traveling salesman problem / reorders stops", "Distinguishes optimization_tool from directions_tool (directions doesn't reorder stops)", "Distinguishes optimization_tool from matrix_tool (matrix gives travel times between all pairs but doesn't compute optimal ordering)", "Optionally mentions that search_and_geocode_tool can be used first to geocode any addresses" ] }, { "id": 3, "prompt": "A user asks: 'How far is the Statue of Liberty from Times Square?' I'm building a chatbot — which Mapbox MCP tool should I use, and what should I clarify with the user?", "expected_output": "Should flag the ambiguity between straight-line distance (distance_tool) and driving/transit distance (directions_tool). Should recommend clarifying 'as the crow flies' vs actual road distance before choosing a tool.", "files": [], "expectations": [ "Identifies the ambiguity: 'distance' could mean straight-line or road distance", "Recommends distance_tool for straight-line / as-the-crow-flies distance", "Recommends directions_tool for actual road/transit distance", "Suggests clarifying with the user which meaning they intend" ] }, { "id": 4, "prompt": "I'm building a real-time fleet tracking app. Every 2 seconds I get a GPS coordinate for each of my 50 trucks and need to check if any of them have entered or left our restricted zones (stored as GeoJSON polygons). What's the right Mapbox MCP approach?", "expected_output": "Should recommend point_in_polygon_tool for the containment checks. Ideally also addresses the architectural concern: at 50 trucks × 0.5Hz, calling MCP tools directly may hit overhead limits, so Turf.js in-process is the correct hot-path approach while MCP tools handle peripheral tasks (zone definition, rerouting). Should NOT suggest routing APIs for containment checks.", "files": [], "expectations": [ "Recommends point_in_polygon_tool (or equivalent Turf.js booleanPointInPolygon) for the containment checks", "Explains that point_in_polygon_tool is an offline geometric tool with instant results", "Addresses scale/architecture: at high call frequency, direct Turf.js use is preferable to MCP tool overhead", "Does NOT