---
name: "xpay-mapbox-static-map-image-tool"
description: "Generates a static map image from Mapbox Static Images API. Supports center coordinates, zoom level (0-22), image size (up to 1280x1280), various Mapbox styles, and overlays (markers, paths, GeoJSON). Returns PNG for vector styles, JPEG for raster-only styles."
version: "1.0.0"
price: "$0.01/call"
provider: "Mapbox"
---

# Static Map Image Tool

Generates a static map image from Mapbox Static Images API. Supports center coordinates, zoom level (0-22), image size (up to 1280x1280), various Mapbox styles, and overlays (markers, paths, GeoJSON). Returns PNG for vector styles, JPEG for raster-only styles.

**Provider:** Mapbox
**Price:** $0.01/call
**Pricing model:** Flat rate per call

## When to Use

Use this tool when you need to generates a static map image from mapbox static images api. supports center coordinates, zoom level (0-22), image size (up to 1280x1280), various mapbox styles, and overlays (markers, paths, geojson). returns png for vector styles, jpeg for raster-only styles.. This is part of the Mapbox provider on xpay✦.

## MCP Connection

Connect to xpay✦ to access this tool (and 8+ others):

```json
{
  "mcpServers": {
    "xpay": {
      "url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
    }
  }
}
```

For Claude Code:
```bash
claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
```

## How to Execute

Use the xpay✦ meta-tools to run this tool:

1. **`xpay_details`** — Get full input schema: `xpay_details("mapbox/static_map_image_tool")`
2. **`xpay_run`** — Execute: `xpay_run("mapbox/static_map_image_tool", { ...inputs })`

## Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zoom` | number | Yes | Zoom level (0-22). Fractional zoom levels are rounded to two decimal places |
| `style` | string | No | Mapbox style ID (e.g., mapbox/streets-v12, mapbox/satellite-v9, mapbox/dark-v11) |
| `size` | object | Yes | Image size as object with width and height properties in pixels. Each dimension must be between 1 and 1280 pixels |
| `highDensity` | boolean | No | Whether to return a high-density (2x) image |
| `center` | object | Yes | Center point of the map as coordinate object with longitude and latitude properties. Longitude: -180 to 180, Latitude: -85.0511 to 85.0511 |
| `overlays` | array | No | Array of overlays to add to the map. Overlays are rendered in order (last item appears on top) |

## Pricing

- **Cost:** $0.01/call
- **Balance check:** Use `xpay_balance` to check remaining credits
- Get your API key at [xpay.tools](https://xpay.tools/account/settings/api-keys/) — $5 free credits included

## Related Skills

- [Mapbox (all tools)](https://xpay.tools/skills/mapbox/SKILL.md) — 9 tools
- [Version Tool](https://xpay.tools/skills/mapbox/version-tool/SKILL.md) — $0.01/call
- [Category Search Tool](https://xpay.tools/skills/mapbox/category-search-tool/SKILL.md) — $0.01/call
- [Directions Tool](https://xpay.tools/skills/mapbox/directions-tool/SKILL.md) — $0.01/call
- [Forward Geocode Tool](https://xpay.tools/skills/mapbox/forward-geocode-tool/SKILL.md) — $0.01/call
- [Isochrone Tool](https://xpay.tools/skills/mapbox/isochrone-tool/SKILL.md) — $0.01/call

## Links

- Tool page: https://xpay.tools/mapbox/static-map-image-tool/
- Provider: https://xpay.tools/mapbox/
- All tools: https://xpay.tools/explore