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-officialHow 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
- The tools ask for a login every time or fail — open
/mcp, pick the Mapbox server and finish the browser sign-in, then click "Allow" — https://github.com/mapbox/mcp-server/blob/main/docs/hosted-mcp-guide.md - The map is blank in your site — the page needs a valid public access token; create one in your Mapbox account — https://docs.mapbox.com/help/dive-deeper/access-tokens/
- A bill you did not expect — check usage against the free tiers on the pricing page and restrict tokens to your own URLs — https://www.mapbox.com/pricing
- You only want the skills, not the servers —
npx skills add mapbox/mapbox-agent-skillsinstalls the skills only — https://github.com/mapbox/mapbox-agent-skills
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, thencodex plugin marketplace add ., then installmapboxin Codex). - Cursor and VS Code (GitHub Copilot):
npx skills add mapbox/mapbox-agent-skills -a cursoror-a vscodeinstalls the skills only (README). - Other agents:
npx skills add mapbox/mapbox-agent-skills, or add--skill mapbox-web-performance-patternsfor 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.
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
- github.com/mapbox/mapbox-agent-skills
- github.com/mapbox/mcp-server
- github.com/mapbox/mcp-devkit-server
- mapbox.com/pricing