Mapbox

liveTravelGeography

Mapbox — forward/reverse geocoding, turn-by-turn routing, distance matrices, isochrones, and GPS trace snapping.

8tools
0msauth
free tier50 calls/day
🔑Authentication

BYO access token only — a Mapbox token bills against the account that owns it, so Pipeworx does not front a shared one. Pass your token as _apiKey on the gateway URL.

Config with credentials
{
  "mcpServers": {
    "pipeworx-mapbox": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gateway.pipeworx.io/mapbox/mcp?_apiKey=your_mapbox_token"
      ]
    }
  }
}

Get an API key →

Tools

geocode_forward

"What are the coordinates of [address]" / "geocode [place]" / "lat lng for [location]" / "find [city] on a map" — convert a street address, city, or place name to GPS coordinates (longitude / latitude

No parameters required.

▶Try it
geocode_reverse

"What's at [lat,lng]" / "reverse geocode coordinates" / "what address is at these coords" / "what place is at this GPS point" — convert longitude / latitude into the nearest street address, neighborho

No parameters required.

▶Try it
directions

"Directions from A to B" / "how long does it take to drive from X to Y" / "how far is [A] from [B]" / "walking / cycling / driving directions" / "navigation between points" / "shortest route" — turn-b

No parameters required.

▶Try it
directions_matrix

"Distance matrix" / "drive times between multiple points" / "travel times grid" / "all-to-all distances" — N×M distance and duration matrix between many coordinates. Use for traveling-salesman, delive

No parameters required.

▶Try it
isochrone

"How far can I get in [N] minutes from [point]" / "reachable area in [time]" / "drive-time / walk-time / cycle-time polygons" / "delivery zone within [radius]" / "service area around [location]" — iso

No parameters required.

▶Try it
map_matching

"Snap GPS trace to roads" / "clean up noisy GPS coordinates" / "match track to road network" — takes a sequence of GPS points and returns the most likely path along the road network. Use for vehicle t

No parameters required.

▶Try it
tilequery

Query features inside a Mapbox vector tile around a coordinate — what POIs / roads / boundaries / buildings are within a radius of a point. Specialized GIS query against a specific tileset_id; most us

No parameters required.

▶Try it
static_image_url

"Static map image of [location]" / "embed a map of [coords]" / "screenshot a map" / "thumbnail map" — generates a Mapbox static-tile image URL for embedding in slack, docs, emails, or dashboards. Pass

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/mapbox/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/mapbox/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"geocode_forward","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("geocode_forward", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("mapbox — forward/reverse geocoding, turn-by-turn routing, distance matrices, isochrones, and gps trace snapping");