Forward Geocode Tool
forward_geocode_toolForward geocode addresses, cities, towns, neighborhoods, districts, postcodes, regions, and countries using Mapbox Geocoding API v6. Converts location name into geographic coordinates. Setting a proximity point helps to bias results towards a specific area for more relevant results. Do not use this tool for geocoding points of interest like businesses, landmarks, historic sites, museums, etc. Supports both JSON and text output formats.
When to Use
Use this tool when you need to forward geocode addresses, cities, towns, neighborhoods, districts, postcodes, regions, and countries using mapbox geocoding api v6. converts location name into geographic coordinates. setting a proximity point helps to bias results towards a specific area for more relevant results. do not use this tool for geocoding points of interest like businesses, landmarks, historic sites, museums, etc. 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):
{
"mcpServers": {
"xpay": {
"url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
}
}
}
For Claude Code:
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:
xpay_details— Get full input schema:xpay_details("mapbox/forward_geocode_tool")xpay_run— Execute:xpay_run("mapbox/forward_geocode_tool", { ...inputs })
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Search text to geocode. Max 256 characters, 20 words, no semicolons. |
country | array | No | Array of ISO 3166 alpha 2 country codes to limit results |
types | array | No | Array of feature types to filter results |
autocomplete | boolean | No | Return partial/suggested results for partial queries |
proximity | string | No | Location to bias results towards. Either [longitude, latitude] coordinates or "ip" for IP-based location. Can help get more relevant results when searching in a specific area. |
permanent | boolean | No | Whether results can be stored permanently |
bbox | object | No | Bounding box to limit results within specified bounds |
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. |
limit | number | No | Maximum number of results to return (1-10) |
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 |
Pricing
- Cost: $0.01/call
- Balance check: Use
xpay_balanceto check remaining credits - Get your API key at xpay.tools — $5 free credits included
Related Skills
- Mapbox (all tools) — 9 tools
- Version Tool — $0.01/call
- Category Search Tool — $0.01/call
- Directions Tool — $0.01/call
- Isochrone Tool — $0.01/call
- Matrix Tool — $0.01/call
Links
- Tool page: https://xpay.tools/mapbox/forward-geocode-tool/
- Provider: https://xpay.tools/mapbox/
- All tools: https://xpay.tools/explore
How to Execute
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Search text to geocode. Max 256 characters, 20 words, no semicolons. |
country | array | No | Array of ISO 3166 alpha 2 country codes to limit results |
types | array | No | Array of feature types to filter results |
autocomplete | boolean | No | Return partial/suggested results for partial queries |
proximity | string | No | Location to bias results towards. Either [longitude, latitude] coordinates or "ip" for IP-based location. Can help get more relevant results when searching in a specific area. |
permanent | boolean | No | Whether results can be stored permanently |
bbox | object | No | Bounding box to limit results within specified bounds |
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. |
limit | number | No | Maximum number of results to return (1-10) |
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 |
Install Skill
Pricing
Cost
$0.01/call
Model
Flat rate
Provider
Mapbox