PluginInstalls cleanly

Build maps and store finders with Mapbox

Mapbox Agent Skills

Mapbox's official skills and three hosted MCP servers help your assistant add maps, search, store locators and directions to web and mobile apps.

Works with
Claude Code, Codex CLI
Good for
Web developers

What it does

Mapbox makes maps, place search and directions for websites and apps. This plugin gives your assistant 20 Mapbox skills and connects three MCP servers that Mapbox hosts: maps and search, the developer DevKit (styles and tokens), and the docs. The docs server needs no account; the other two ask you to sign in to Mapbox.

The skills cover web frameworks (React, Vue, Svelte, Angular, Next.js), iOS, Android and Flutter, with patterns for map speed, map style design, search, store locators, navigation, data visualisation, token security, and moving from Google Maps or MapLibre to Mapbox.

Example prompts

  • "Add a Mapbox store locator to this Next.js site with our 12 shop addresses."
  • "Our map page is slow on phones; check it against the Mapbox performance patterns."
  • "Add an address search box with autocomplete to the checkout form."
  • "Move this page from Google Maps to Mapbox and keep the same markers."

How to install

/plugin install mapbox@claude-plugins-official

How to use it

Ask: Add a Mapbox store locator to this Next.js site with our 12 shop addresses. Sign in to Mapbox when the browser opens.

Check it works

In Claude Code, run /mcp and check that the mapbox, mapbox-devkit and mapbox-docs servers are listed. Sign in to Mapbox for the first two when asked. Then ask "Which Mapbox skills do you have?" and you should see names such as mapbox-web-performance-patterns.

Common problems

Other assistants

  • Codex: the repo has a Codex plugin manifest and marketplace, but the README only gives steps for local testing from a clone (npm run build:codex-plugin, then codex plugin marketplace add ., then install mapbox in Codex).
  • Cursor and VS Code (GitHub Copilot): npx skills add mapbox/mapbox-agent-skills -a cursor or -a vscode installs the skills only (README).
  • Other agents: npx skills add mapbox/mapbox-agent-skills, or add --skill mapbox-web-performance-patterns for one skill (README).
  • Gemini CLI: the repository does not mention Gemini CLI.

What to watch out for

  • You need a Mapbox account: the maps and DevKit servers ask you to sign in, and your site needs an access token. Mapbox is pay-as-you-go with free tiers for most products, so use above a free tier is billed (pricing page)
  • The plugin connects three MCP servers that Mapbox hosts (mcp.mapbox.com, mcp-devkit.mapbox.com, mcp-docs.mapbox.com), so your requests go through Mapbox's servers; only the docs server works without a token (.mcp.json, mcp-docs-server README)
  • The DevKit server has tools that create, update and delete map styles and create access tokens in your account, if your token has the styles:write or tokens:write scope (mcp-devkit-server README)
  • The Mapbox MCP server README lists a new feedback tool that sends reports about wrong map data to Mapbox under your account, if your token has the user-feedback:write scope. It asks you first, and Mapbox says reports may be billed after the preview ends (mcp-server README and CHANGELOG)

Licence and author

Licence
MIT
Author
Mapbox
Source code
github.com/mapbox/mapbox-agent-skills

How we tested it

We installed it on an empty test computer on 28 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

Not yet used on real work.

Technical details of the test
Date
28 Oct 2026
Method
Intake sandbox run on 2026-10-28 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; installed mapbox@claude-plugins-official with the Claude Code command line.

Checked again on 28 Oct 2026

Alternatives

  • Modern Web Guidance — general web building advice, not maps
  • Zapier MCP — for app actions rather than maps

FAQ

  • Q: Does it cost money? A: The skills are free (MIT licence). Mapbox itself is pay-as-you-go, with free tiers for most products (pricing page). You need a Mapbox account.
  • Q: Do I need to code? A: The skills write real code for your site or app, so this is for people building one.
  • Q: Does my data leave my computer? A: Yes. The plugin uses servers that Mapbox runs, so your requests and your sign-in go to Mapbox. If you want the server on your own computer, the mcp-server README shows how to run it yourself with your own token.

Sources