Poi Search Tool
poi_search_toolFind one specific place or brand location by its proper name or unique brand. Use only when the user's query includes a distinct title (e.g., "The Met", "Starbucks Reserve Roastery") or a brand they want all nearby branches of (e.g., "Macy's stores near me"). Do not use for generic place types such as 'museums', 'coffee shops', 'tacos', etc. Setting a proximity point is strongly encouraged for more relevant results. Always try to use a limit of at least 3 in case the user's intended result is not the first result. Supports both JSON and text output formats.
When to Use
Use this tool when you need to find one specific place or brand location by its proper name or unique brand. use only when the user's query includes a distinct title (e.g., "the met", "starbucks reserve roastery") or a brand they want all nearby branches of (e.g., "macy's stores near me"). do not use for generic place types such as 'museums', 'coffee shops', 'tacos', etc. setting a proximity point is strongly encouraged for more relevant results. always try to use a limit of at least 3 in case the user's intended result is not the first result. 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/poi_search_tool")xpay_run— Execute:xpay_run("mapbox/poi_search_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 (e.g., ["poi", "address", "place"]) |
bbox | object | No | Bounding box to limit results within specified bounds |
eta_type | string | No | Request estimated time of arrival (ETA) to results |
origin | object | No | Starting point for ETA calculations as coordinate object with longitude and latitude |
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 | ISO language code for the response (e.g., "en", "es", "fr", "de", "ja") |
navigation_profile | string | No | Routing profile for ETA calculations |
auto_complete | boolean | No | Enable partial and fuzzy matching |
q | string | Yes | Search query text. Limited to 256 characters. |
proximity | string | No | Location to bias results towards. Either coordinate object with longitude and latitude or "ip" for IP-based location. STRONGLY ENCOURAGED for relevant results. |
limit | number | No | Maximum number of results to return (1-10) |
poi_category | array | No | Array of POI categories to include (e.g., ["restaurant", "cafe"]) |
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
- Forward Geocode Tool — $0.01/call
- Isochrone Tool — $0.01/call
Links
- Tool page: https://xpay.tools/mapbox/poi-search-tool/
- Provider: https://xpay.tools/mapbox/
- All tools: https://xpay.tools/explore
How to Execute
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 (e.g., ["poi", "address", "place"]) |
bbox | object | No | Bounding box to limit results within specified bounds |
eta_type | string | No | Request estimated time of arrival (ETA) to results |
origin | object | No | Starting point for ETA calculations as coordinate object with longitude and latitude |
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 | ISO language code for the response (e.g., "en", "es", "fr", "de", "ja") |
navigation_profile | string | No | Routing profile for ETA calculations |
auto_complete | boolean | No | Enable partial and fuzzy matching |
q | string | Yes | Search query text. Limited to 256 characters. |
proximity | string | No | Location to bias results towards. Either coordinate object with longitude and latitude or "ip" for IP-based location. STRONGLY ENCOURAGED for relevant results. |
limit | number | No | Maximum number of results to return (1-10) |
poi_category | array | No | Array of POI categories to include (e.g., ["restaurant", "cafe"]) |
Install Skill
Pricing
Cost
$0.01/call
Model
Flat rate
Provider
Mapbox