# Mapbox

Find places and addresses with precise geocoding, or search by category or brand. Plan routes and compare travel times using directions, isochrones, and distance matrices. Generate static map images …

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add Waldzell-Agentics/mcp-server

# Browse available tools
npx -y @smithery/cli@latest tool list Waldzell-Agentics/mcp-server

# Get full schema for a tool
npx -y @smithery/cli@latest tool get Waldzell-Agentics/mcp-server version_tool

# Call a tool
npx -y @smithery/cli@latest tool call Waldzell-Agentics/mcp-server version_tool '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-server--waldzell-agentics.run.tools`

**Required config:**
- `MAPBOX_ACCESS_TOKEN` (query) — Your Mapbox secret access token

**Optional config:**
- `VERBOSE_ERRORS` (query) — Enable detailed error messages for debugging

## Tools (9)

- `version_tool` — Get the current version information of the MCP server
- `category_search_tool` — Return all places that match a category (industry, amenity, or NAICS‑style code). Use when the user asks for a type of …
- `directions_tool` — Fetches directions from Mapbox API based on provided coordinates and direction method.
- `forward_geocode_tool` — Forward geocode addresses, cities, towns, neighborhoods, districts, postcodes, regions, and countries using Mapbox Geoc…
- `isochrone_tool` — Computes areas that are reachable within a specified amount of time from a location, and returns the reachable regions …
- `matrix_tool` — Calculates travel times and distances between multiple points using Mapbox Matrix API.
- `poi_search_tool` — Find one specific place or brand location by its proper name or unique brand. Use only when the user's query includes a…
- `reverse_geocode_tool` — Find addresses, cities, towns, neighborhoods, postcodes, districts, regions, and countries around a specified geographi…
- `static_map_image_tool` — Generates a static map image from Mapbox Static Images API. Supports center coordinates, zoom level (0-22), image size …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get Waldzell-Agentics/mcp-server <tool-name>
```

---

Source: https://github.com/Waldzell-Agentics/mcp-server