---
name: "xpay-mapbox-reverse-geocode-tool"
description: "Find addresses, cities, towns, neighborhoods, postcodes, districts, regions, and countries around a specified geographic coordinate pair. Converts geographic coordinates (longitude, latitude) into human-readable addresses or place names. Use limit=1 for best results. This tool cannot reverse geocode businesses, landmarks, historic sites, and other points of interest that are not of the types mentioned. Supports both JSON and text output formats."
version: "1.0.0"
price: "$0.01/call"
provider: "Mapbox"
---

# Reverse Geocode Tool

Find addresses, cities, towns, neighborhoods, postcodes, districts, regions, and countries around a specified geographic coordinate pair. Converts geographic coordinates (longitude, latitude) into human-readable addresses or place names. Use limit=1 for best results. This tool cannot reverse geocode businesses, landmarks, historic sites, and other points of interest that are not of the types mentioned. Supports both JSON and text output formats.

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

## When to Use

Use this tool when you need to find addresses, cities, towns, neighborhoods, postcodes, districts, regions, and countries around a specified geographic coordinate pair. converts geographic coordinates (longitude, latitude) into human-readable addresses or place names. use limit=1 for best results. this tool cannot reverse geocode businesses, landmarks, historic sites, and other points of interest that are not of the types mentioned. supports both json and text output formats.. 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/reverse_geocode_tool")`
2. **`xpay_run`** — Execute: `xpay_run("mapbox/reverse_geocode_tool", { ...inputs })`

## Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `country` | array | No | Array of ISO 3166 alpha 2 country codes to limit results |
| `types` | array | No | Array of feature types to filter results |
| `permanent` | boolean | No | Whether results can be stored permanently |
| `latitude` | number | Yes | Latitude coordinate to reverse geocode |
| `limit` | number | No | Maximum number of results (1-5). Use 1 for best results. If you need more than 1 result, you must specify exactly one type in the types parameter. |
| `format` | string | No | Output format: "json_string" returns raw GeoJSON data as a JSON string that can be parsed; "formatted_text" returns human-readable text with place names, addresses, and coordinates. Both return as text content but json_string contains parseable JSON data while formatted_text is for display. |
| `language` | string | No | IETF language tag for the response (e.g., "en", "es", "fr", "de", "ja") |
| `worldview` | string | No | Returns features from a specific regional perspective |
| `longitude` | number | Yes | Longitude coordinate to reverse geocode |

## 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/reverse-geocode-tool/
- Provider: https://xpay.tools/mapbox/
- All tools: https://xpay.tools/explore