Array of ISO 3166 alpha 2 country codes to limit results
Location to bias results towards. Either coordinate object with longitude and latitude or "ip" for IP-based location
Bounding box to limit results within specified bounds
Maximum number of results to return (1-25)
formatted_text
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.
ISO language code for the response (e.g., "en", "es", "fr", "de", "ja")
Return all places that match a category (industry, amenity, or NAICS‑style code). Use when the user asks for a type of place, plural or generic terms like 'museums', 'coffee shops', 'electric‑vehicle chargers', or when the query includes is‑a phrases such as 'any', 'all', 'nearby'. Do not use when a unique name or brand is provided. Supports both JSON and text output formats.
Frequently Asked Questions
Return all places that match a category (industry, amenity, or NAICS‑style code). Use when the user asks for a type of place, plural or generic terms like 'museums', 'coffee shops', 'electric‑vehicle chargers', or when the query includes is‑a phrases such as 'any', 'all', 'nearby'. Do not use when a unique name or brand is provided. Supports both JSON and text output formats.
Category 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 category_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/category_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 Category Search Tool immediately. Billing flows through your xpay balance.
Category Search Tool accepts 8 input parameters: country, proximity, bbox, limit, format, language…. See the input schema and runnable form on this page for details and to test live.