Mapbox Mcp Runtime Patterns

If you're building an AI app that needs to work with maps and location data, this walks you through integrating Mapbox's MCP server into frameworks like Pydantic AI, LangChain, CrewAI, and Mastra. It covers both the hosted server option and self-hosting, explains when to use offline tools versus API calls, and includes patterns for real-world scenarios like food delivery and real estate apps. The best part is the guidance on tool selection, helping your LLM understand when to use straight-line distance versus routing or category search versus geocoding. Comes with production patterns for caching, rate limiting, and error handling.

skills.sh installs: 1.4K
GitHub stars: 86
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add mapbox/mapbox-agent-skills --skill mapbox-mcp-runtime-patterns --agent claude-code

Installs into .claude/skills of the current project.

Files

Mapbox MCP Runtime Patterns

This skill provides patterns for integrating the Mapbox MCP Server into AI applications for production use with geospatial capabilities.

What is Mapbox MCP Server?

The Mapbox MCP Server is a Model Context Protocol (MCP) server that provides AI agents with geospatial tools:

Offline Tools (Turf.js):

Distance, bearing, midpoint calculations
Point-in-polygon tests
Area, buffer, centroid operations
Bounding box, geometry simplification
No API calls, instant results

Mapbox API Tools:

Directions and routing
Reverse geocoding
POI category search
Isochrones (reachability)
Travel time matrices
Static map images
GPS trace map matching
Multi-stop route optimization

Utility Tools:

Server version info
POI category list

Key benefit: Give your AI application geospatial superpowers without manually integrating multiple APIs.

Understanding Tool Categories

Before integrating, understand the key distinctions between tools to help your LLM choose correctly:

Distance: "As the Crow Flies" vs "Along Roads"

Straight-line distance (offline, instant):

SKILL.md on GitHub

Details

Repository: github.com/mapbox/mapbox-agent-skills
Categories: Backend & APIs, AI & Agent Building, Python
First seen: Jun 3, 2026

More from mapbox/mapbox-agent-skills

All 18

acomoprogress-all/acomo-skillsプラットフォーム利用者（acomo 上でワークフローモデルを使って開発する開発者）向け。 acomo CLI および公開 API の標準的な使い方（モデル取得・プロセス操作・認証）を案内する。 acomo 本体の内部実装は対象外。 acomo CLI を使うとき、ワークフローやプロセスの操作・モデル定義の確認を行うとき1.4Kskills.sh installs

azure-container-appsmicrosoftdocs/agent-skillsExpert knowledge for Azure Container Apps development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quota1.4Kskills.sh installs

polymarketmachina-sports/sports-skillsPolymarket sports prediction markets — read-only live odds, prices, order books, events, series, and market search. No auth required. Covers NFL, NBA, MLB, foot1.4Kskills.sh installs

eloquent-best-practicesiserter/laravel-claude-agentsBest practices for Laravel Eloquent ORM including query optimization, relationship management, and avoiding common pitfalls like N+1 queries.1.3Kskills.sh installs

capacitor-securitycap-go/capgo-skillsComprehensive security guide for Capacitor apps using Capsec scanner. Covers 63+ security rules across secrets, storage, network, authentication, cryptography, 1.3Kskills.sh installs

safe-action-clientnext-safe-action/skillsUse when creating or configuring a next-safe-action client, defining actions with input/output validation, handling server errors, or setting up createSafeActio1.2Kskills.sh installs