xpay tools logo
  • Tools
  • Collections
  • Skills
  • Docs
  • xpay.sh
  1. Home
  2. ›
  3. Mapbox
  4. ›
  5. Poi Search Tool

Mapbox
Mapbox
Tool

Poi Search Tool

poi_search_tool

Find one specific place or brand location by its proper name or unique brand.

How it works ↓

Pricing

Per call

$0.01

Model

flat


Pay only for what you use. No subscriptions.
Inputs

country

array

types

array

bbox

object

eta_type

string

origin

object

format

string

language

string

navigation_profile

string

auto_complete

boolean

q *

string

proximity

string

limit

number

poi_category

array
Try It
API
MCP Config
Input Parameters
country
Array of ISO 3166 alpha 2 country codes to limit results
types
Array of feature types to filter results (e.g., ["poi", "address", "place"])
bbox
Bounding box to limit results within specified bounds
​
eta_type
Request estimated time of arrival (ETA) to results
origin
Starting point for ETA calculations as coordinate object with longitude and latitude
formatted_text
format
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
ISO language code for the response (e.g., "en", "es", "fr", "de", "ja")
​
navigation_profile
Routing profile for ETA calculations
q *
Search query text. Limited to 256 characters.
proximity
Location to bias results towards. Either coordinate object with longitude and latitude or "ip" for IP-based location. STRONGLY ENCOURAGED for relevant results.
limit
Maximum number of results to return (1-10)
poi_category
Array of POI categories to include (e.g., ["restaurant", "cafe"])
Cost per run
Execution cost
$0.01
Deducted from your xPay allowance
About 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 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.

Frequently Asked Questions

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.

Poi Search Tool costs $0.01 per call on xpay. No subscription, no minimums. Pay only for the calls you make. New accounts get $5 in free credits.

Connect the Mapbox MCP endpoint to your client — Claude Code: claude mcp add --transport http mapbox "https://mapbox.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"; Cursor/Windsurf/Cline/VS Code: same URL in mcp.json. The agent will see poi_search_tool as a callable tool with the input schema and run it directly. (Unified across all providers: https://mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY, then xpay_run with toolPath mapbox/poi_search_tool.)

Yes — that's exactly what xpay is for. You don't need a Mapbox account or API key. Sign up at xpay.tools (Google or email), get $5 free credit, and run Poi Search Tool immediately. Billing flows through your xpay balance.

Poi Search Tool accepts 13 input parameters: country, types, bbox, eta_type, origin, format…. See the input schema and runnable form on this page for details and to test live.

xpay tools logo

Marketplace for AI Capabilities. Run agents, tools & prompts with pay-per-use micropayments.

or ask your AI app
Popular Tools
FirecrawlTavilyExaHunterPerplexityRecraftIdeogramFlux
Collections
AI Image & MediaContent & ResearchDev ToolsFinanceLead GenWeb ScrapingCompetitive Intel
Developers
DocumentationAPI ReferenceQuickstartSDKsSkillsskill.mdllms.txt
Resources
The Agentic EconomyAgentic CommerceAgent Frameworksx402 ProtocolBlog
Company
About xpayxpay.shGitHubDiscordTwitter / X

© 2026 Agentically Inc. All rights reserved.
Privacy PolicyTerms of Service
✦
xpay Assistant
Poi Search Tool by Mapbox

Ask me about tools, pricing, or how to connect

How does this tool work?
What parameters does it accept?
Show me a usage example
DocsCollectionsExplore