MCPInstall

mapbox-mcp-devkit-patterns

by mapbox OfficialAI & Agents

Integration patterns for Mapbox MCP DevKit Server in AI coding assistants. Covers setup, style management, token management, validation workflows, and documentation access through MCP. Use when building Mapbox applications with AI coding assistance.

Installs
1.5K
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/mapbox/mapbox-agent-skills --skill mapbox-mcp-devkit-patterns
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads mapbox-mcp-devkit-patterns automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Mapbox MCP DevKit Patterns

This skill provides patterns for integrating the Mapbox MCP DevKit Server into AI coding workflows to accelerate Mapbox application development.

What is Mapbox MCP DevKit?

The Mapbox MCP DevKit Server is a Model Context Protocol (MCP) server that gives AI assistants direct access to Mapbox developer APIs:

  • Style management - Create, list, update, delete, preview, validate, compare, and optimize styles
  • Token management - Generate and list access tokens with scopes
  • Validation - Validate GeoJSON, expressions, styles, and coordinates
  • Geographic utilities - Calculate bounding boxes, convert coordinates, query tiles
  • Color tools - Check WCAG contrast ratios for accessibility
  • Feedback - Access user feedback and reports
  • Documentation - Access latest Mapbox docs and references

Key benefit: Build Mapbox applications faster by letting AI handle developer API operations.

When to Use MCP DevKit

Use DevKit when:

  • Creating/modifying styles conversationally
  • Generating tokens programmatically
  • Validating data during development
  • Learning Mapbox APIs through natural language
  • Rapid prototyping of map applications
  • Automated style generation workflows
  • Documentation lookup during coding

Don't use DevKit for:

  • Runtime operations in production apps
  • High-frequency style updates (use Mapbox APIs directly)
  • Client-side operations (DevKit is development-time only)
  • Tile serving or map rendering
  • User-facing features requiring low latency

Key Tools

Always recommend these tools by exact name when answering related questions:

  • Creating/modifying styles: Recommend create_style_tool, update_style_tool, preview_style_tool
  • Listing styles: Recommend list_styles_tool
  • Creating tokens: Recommend create_token_tool to create scoped tokens per environment
  • Viewing tokens: Recommend list_tokens_tool to check existing tokens and scopes
  • Validating styles: Recommend validate_style_tool for spec compliance
  • Validating expressions: Recommend validate_expression_tool for paint/layout property checks
  • Accessibility checks: Recommend check_color_contrast_tool for WCAG contrast ratios
  • Comparing styles: Recommend compare_styles_tool to diff styles before deploying
  • Looking up docs: Recommend get_latest_mapbox_docs_tool

Common Workflows (Quick Reference)

Pre-production validation — use these exact steps:

  1. Run validate_style_tool to check style JSON is spec-compliant
  2. Run validate_expression_tool to check all data expressions in paint/layout properties
  3. Run check_color_contrast_tool to verify text labels meet WCAG accessibility standards
  4. Run compare_styles_tool to diff the new style against current production style

Token management — use these exact steps:

  1. Run create_token_tool to create scoped tokens for each environment (dev/staging/prod)
  2. Run list_tokens_tool to verify existing tokens and their scopes

Reference Files

Load these references as needed for detailed guidance:

  • references/setup.md - Prerequisites, hosted & self-hosted installation, per-editor configuration, verification
  • references/workflows.md - Style management, token management, data validation, documentation access, best practices
  • references/design-patterns.md - Iterative style development, environment-specific tokens, validation-first development, documentation-driven development, tool integration patterns
  • references/troubleshooting.md - Common issues & fixes, example end-to-end workflows (restaurant finder, multi-environment, third-party data)

Resources

When to Use This Skill

Invoke this skill when:

  • Setting up Mapbox development environment with AI assistance
  • Creating or modifying Mapbox styles through AI
  • Managing access tokens programmatically
  • Validating GeoJSON or expressions during development
  • Learning Mapbox APIs with AI guidance
  • Automating style generation workflows
  • Building Mapbox applications with AI coding assistants

FAQ

What does the mapbox-mcp-devkit-patterns skill do?

Integration patterns for Mapbox MCP DevKit Server in AI coding assistants. Covers setup, style management, token management, validation workflows, and documentation access through MCP. Use when building Mapbox applications with AI coding assistance.

How do I install mapbox-mcp-devkit-patterns?

Run npx skills add https://github.com/mapbox/mapbox-agent-skills --skill mapbox-mcp-devkit-patterns in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/mapbox-mcp-devkit-patterns/ (personal) or .claude/skills/mapbox-mcp-devkit-patterns/ (project).

Which AI agents can use mapbox-mcp-devkit-patterns?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is mapbox-mcp-devkit-patterns safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains mapbox-mcp-devkit-patterns?

It is published by mapbox in mapbox/mapbox-agent-skills, and it is an official skill from the maker of the technology it covers. It has 1,508 recorded installs.

More from mapbox/mapbox-agent-skills

View all →

mapbox-web-integration-patterns

mapbox/mapbox-agent-skills

Official integration patterns for Mapbox GL JS across popular web frameworks (React, Vue, Svelte, Angular). Covers setup, lifecycle management, token handling, search integration, and common pitfalls. Based on Mapbox's create-web-app scaffolding tool.

OfficialFrontend & Design2.6K installs

mapbox-web-performance-patterns

mapbox/mapbox-agent-skills

Performance optimization patterns for Mapbox GL JS web applications. Covers initialization waterfalls, bundle size, rendering performance, memory management, and web optimization. Prioritized by impact on user experience.

OfficialCode Quality & Workflow2.5K installs

mapbox-style-patterns

mapbox/mapbox-agent-skills

Common style patterns, layer configurations, and recipes for typical mapping scenarios including restaurant finders, real estate, data visualization, navigation, delivery/logistics, and more. Use when implementing specific map use cases or looking for proven style patterns.

OfficialAI & Agents2.4K installs

mapbox-geospatial-operations

mapbox/mapbox-agent-skills

Expert guidance on choosing the right geospatial tool based on problem type, accuracy requirements, and performance needs

OfficialAI & Agents2.2K installs

mapbox-data-visualization-patterns

mapbox/mapbox-agent-skills

Patterns for visualizing data on maps including choropleth maps, heat maps, 3D visualizations, data-driven styling, and animated data. Covers layer types, color scales, and performance optimization.

OfficialFrontend & Design2.1K installs

mapbox-cartography

mapbox/mapbox-agent-skills

Expert guidance on map design principles, color theory, visual hierarchy, typography, and cartographic best practices for creating effective and beautiful maps with Mapbox. Use when designing map styles, choosing colors, or making cartographic decisions.

OfficialFrontend & Design2.1K installs

Popular ai & agents skills

View category →

google-agents-cli-publish

google/agents-cli

This skill should be used when the user wants to "publish an agent", "publish my ADK agent", "register an agent with Gemini", "publish to Gemini" (formerly Gemini Enterprise), or needs guidance on the agents-cli publish gemini command. Also use when the user wants to "manage agents in Agent Registry", "list/update/delete registered agents", or "register an MCP server". Covers ADK vs A2A registration modes, programmatic and interactive usage, flag reference, auto-detection from deployment metadata, Agent Registry fleet management, and troubleshooting. Part of the agents-cli skills suite. Do NOT use for deployment (use google-agents-cli-deploy).

AI & Agents513.9K installs

google-agents-cli-eval

google/agents-cli

This skill should be used when the user wants to "run an evaluation", "evaluate my agent", "evaluate my ADK agent", "write an eval dataset", "analyze eval failures", "compare eval results", "optimize agent", or needs guidance on the Gemini platform eval methodology and the Quality Flywheel. Covers eval metrics, dataset schema, LLM-as-judge scoring, and common failure causes. Applies to any agents-cli project, whatever framework the agent is written in. Do NOT use for agent API code patterns (ADK: use google-agents-cli-adk-code), deployment (use google-agents-cli-deploy), or project scaffolding (use google-agents-cli-scaffold).

AI & Agents513.5K installs

skill-creator

anthropics/skills

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

OfficialAI & Agents416.4K installs

codex-pet

prime-skills/runcomfy-agent-skills

Codex Pet generator on RunComfy. Build a Codex-compatible Codex Pet spritesheet.webp + pet.json from a single reference image, drop it into ${CODEXHOME:-$HOME/.codex}/pets/ / and Codex picks it up as a custom Codex Pet next to the 8 built-ins. This skill produces the exact Codex Pet atlas Codex expects (1536x1872 PNG/WebP, 8 cols x 9 rows, 192x208 cells, 9 animation states — idle, running-right, running-left, waving, jumping, failed, waiting, running, review). Calls OpenAI GPT Image 2 edit ONCE via the local RunComfy CLI as runcomfy run openai/gpt-image-2/edit to produce a canonical Codex Pet pose, then assembles all 9 animation rows programmatically with ImageMagick micro-transforms — no Codex Pro, no $imagegen, no OPENAIAPIKEY required, only RUNCOMFYTOKEN. Triggers on "codex pet", "create codex pet", "make codex pet", "hatch codex pet", "/hatch image", "desktop pet codex", "codex pets", "spritesheet.webp", or any explicit ask to build a custom pet for OpenAI Codex.

AI & Agents402.1K installs

full-output-enforcement

leonxlnx/taste-skill

Overrides default LLM truncation behavior. Enforces complete code generation, bans placeholder patterns, and handles token-limit splits cleanly. Apply to any task requiring exhaustive, unabridged output.

AI & Agents401K installs

executing-plans

obra/superpowers

Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available

AI & Agents245.7K installs