`static_image_url`

Pack: mapbox · Endpoint: https://gateway.pipeworx.io/mapbox/mcp

“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 style + coords + zoom + width/height; returns a fetchable PNG URL. No client-side JS or interactivity required.

Parameters

Name	Type	Required
`style_id`	string	yes
`lon`	number	yes
`lat`	number	yes
`zoom`	number	yes
`width`	number	yes
`height`	number	yes
`bearing`	number	no
`pitch`	number	no
`retina`	boolean	no

Example call

Arguments

{
  "style_id": "light-v10",
  "lon": -122.4194,
  "lat": 37.7749,
  "zoom": 12,
  "width": 600,
  "height": 400
}

curl

curl -X POST https://gateway.pipeworx.io/mapbox/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"static_image_url","arguments":{"style_id":"light-v10","lon":-122.4194,"lat":37.7749,"zoom":12,"width":600,"height":400}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('static_image_url', {
  "style_id": "light-v10",
  "lon": -122.4194,
  "lat": 37.7749,
  "zoom": 12,
  "width": 600,
  "height": 400
});

More examples

{
  "style_id": "dark-v10",
  "lon": -74.006,
  "lat": 40.7128,
  "zoom": 14,
  "width": 800,
  "height": 600,
  "bearing": 45,
  "pitch": 60,
  "retina": true
}

Response shape

Always returns: url, note

Field	Type	Description
`url`	string	URL to fetch the rendered map image
`note`	string	Instructions for using the URL

Full JSON Schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL to fetch the rendered map image"
    },
    "note": {
      "type": "string",
      "description": "Instructions for using the URL"
    }
  },
  "required": [
    "url",
    "note"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "mapbox": {
      "url": "https://gateway.pipeworx.io/mapbox/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

static_image_url