Local Business Discovery and Mapping by Apoth3osis

Name: Local Business Discovery and Mapping
Brand: Apoth3osis
SKU: 695e8470c309cf48479329e4
Price: 0.20 USD
Availability: InStock

Local Business Discovery and Mapping

Data

Available ActionsEach successful request consumes credits as outlined below.

nearby_search^20crtext_search^20crgeocode^20crreverse_geocode^20cr

Details

Comprehensive place discovery and geocoding service that enables AI agents to search, discover, and analyze physical locations in the real world. The tool provides powerful search capabilities with two primary modes: nearby search for radius-based discovery and text search for flexible keyword-based queries across global locations. The nearby search functionality supports advanced filtering through 30+ predefined category groups, intelligently organized into logical clusters such as restaurants_and_dining (covering 37 restaurant types from fast food to fine dining), health_and_medical (hospitals, doctors, pharmacies), entertainment_and_attractions (museums, theaters, amusement parks), and transportation (airports, train stations, transit stops). Each category group automatically expands to include all relevant place types, enabling precise filtering without manual specification of individual types. Core capabilities include discovering places within a 1-50km radius of any location, searching globally with text queries and optional location bias, forward geocoding to convert addresses into coordinates with place IDs and address components, reverse geocoding to transform coordinates into structured addresses, and intelligent category-based filtering with both inclusion and exclusion options. The tool returns rich place data including names, addresses, ratings, price levels, operating status, and precise coordinates. The tool automatically handles address-to-coordinate conversion when needed, allowing agents to specify search centers using either street addresses or lat/lng coordinates. All searches support configurable result limits up to 50 places per query, with detailed metadata for each discovered location. The integrated geocoding ensures seamless workflow between address-based and coordinate-based operations.

Use Cases

Local business discovery and recommendations for travel planning, Restaurant and dining venue search for meal planning applications, Healthcare facility location for medical service directories, Retail store finding for shopping assistance, Hotel and accommodation search for booking systems, Emergency service location finding for safety applications, Transportation hub discovery for route planning, Educational institution search for school finders, Entertainment venue discovery for event planning, Park and recreation area finding for outdoor activities, Professional service provider location for business directories, Real estate area analysis with nearby amenities, Market research for competitor analysis and site selection, Delivery service area validation and address verification, Tourism point of interest discovery for travel guides

Actions(4)

nearby_search^20cr7 params

Search for places near a location by category. Requires either an address or latitude/longitude coordinates. Automatically geocodes addresses to coordinates.

addressstring

Street address or area name to search near. Will be geocoded to coordinates automatically. Required if latitude/longitude are not provided.

latitudenumber

Latitude coordinate of search center (-90 to 90). Required if address is not provided.

Range: -90 - 90

longitudenumber

Longitude coordinate of search center (-180 to 180). Required if address is not provided.

Range: -180 - 180

included_typesarray

Place category groups to include in search results. Each group expands to multiple specific place types.

Array of: string

excluded_typesarray

Place category groups to exclude from search results.

Array of: string

radius_metersinteger

Search radius in meters around the center point.

Default: 1000

Range: 1 - 50000

max_resultsinteger

Maximum number of results to return.

Default: 50

Range: 1 - 50

text_search^20cr6 params(1 required)

Search for places using a free-text query. Optionally bias results toward a specific location.

queryrequiredstring

Text search query (e.g., 'best pizza in Brooklyn', 'Statue of Liberty').

addressstring

Bias results toward this address. Optional location context.

latitudenumber

Latitude to bias results toward (-90 to 90).

Range: -90 - 90

longitudenumber

Longitude to bias results toward (-180 to 180).

Range: -180 - 180

radius_metersinteger

Bias radius in meters around the location.

Default: 1000

Range: 1 - 50000

max_resultsinteger

Maximum number of results to return.

Default: 50

Range: 1 - 50

geocode^20cr1 param(1 required)

Convert a street address or place name into geographic coordinates, place ID, and address components.

addressrequiredstring

The street address or place name to geocode.

reverse_geocode^20cr2 params(2 required)

Convert latitude/longitude coordinates into a human-readable address with place ID and address components.

latituderequirednumber

Latitude coordinate (-90 to 90).

Range: -90 - 90

longituderequirednumber

Longitude coordinate (-180 to 180).

Range: -180 - 180

Connect Your Agent In 5 Min

Use hosted MCP first, or install the local STDIO fallback when your client requires a command

Hosted Streamable HTTPS

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Endpoint: https://api.agentpmt.com/mcp
Authorization: Bearer <AGENTPMT_BEARER_TOKEN>

Full connection guide

Local STDIO Fallback

Use the local router for Claude Code, Codex, Cursor, Zed, and other clients that require a command-based MCP server. The router forwards requests to the hosted endpoint and does not execute tools locally.

npm install -g @agentpmt/mcp-routeragentpmt-setup

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "695e8470c309cf48479329e4",
    "parameters": {
      "action": "nearby_search",
      "radius_meters": 1000,
      "max_results": 50
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "695e8470c309cf48479329e4",
    "parameters": {
        "action": "nearby_search",
        "radius_meters": 1000,
        "max_results": 50
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "695e8470c309cf48479329e4",
  parameters: {
    "action": "nearby_search",
    "radius_meters": 1000,
    "max_results": 50
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "695e8470c309cf48479329e4",
  parameters: {
    "action": "nearby_search",
    "radius_meters": 1000,
    "max_results": 50
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Usage Instructions

Usage guidance provided directly by the developer for this product.

Local Business Discovery and Mapping

Search for nearby businesses, find places by text query, and convert between addresses and coordinates using Google Maps.

Actions

nearby_search

Search for places near a location by category.

Required: At least one of address OR (latitude + longitude)

Optional:

included_types (array) - Category groups to include (see Category Groups below)
excluded_types (array) - Category groups to exclude
radius_meters (integer, 1-50000, default: 1000) - Search radius in meters
max_results (integer, 1-50, default: 50) - Maximum results to return

Example - Find restaurants near an address:

{
  "action": "nearby_search",
  "address": "Times Square, New York, NY",
  "included_types": ["restaurants_and_dining"],
  "radius_meters": 500,
  "max_results": 10
}

Example - Find hotels near coordinates:

{
  "action": "nearby_search",
  "latitude": 40.7580,
  "longitude": -73.9855,
  "included_types": ["lodging_and_accommodation"],
  "radius_meters": 2000
}

Example - Find everything except restaurants:

{
  "action": "nearby_search",
  "address": "Downtown Chicago, IL",
  "excluded_types": ["restaurants_and_dining", "cafes_and_light_fare"],
  "radius_meters": 1000
}

text_search

Search for places using a free-text query. Optionally bias results toward a location.

Required:

query (string) - The search text

Optional:

address (string) - Bias results toward this address
latitude / longitude (number) - Bias results toward these coordinates
radius_meters (integer, 1-50000, default: 1000) - Bias radius in meters
max_results (integer, 1-50, default: 50) - Maximum results to return

Example - Search by query with location bias:

{
  "action": "text_search",
  "query": "best pizza in Brooklyn",
  "address": "Brooklyn, NY",
  "radius_meters": 5000,
  "max_results": 10
}

Example - Search without location bias:

{
  "action": "text_search",
  "query": "Statue of Liberty"
}

geocode

Convert a street address or place name into geographic coordinates.

Required:

address (string) - The address or place name to geocode

Example:

{
  "action": "geocode",
  "address": "1600 Amphitheatre Parkway, Mountain View, CA"
}

Returns: Formatted address, latitude/longitude, place ID, and address components.

reverse_geocode

Convert geographic coordinates into a human-readable address.

Required:

latitude (number, -90 to 90)
longitude (number, -180 to 180)

Example:

{
  "action": "reverse_geocode",
  "latitude": 37.4224764,
  "longitude": -122.0842499
}

Returns: Formatted address, place ID, and address components.

Category Groups

Use these values in included_types and excluded_types for nearby_search:

Category	What It Includes
restaurants_and_dining	Restaurants of all cuisines (Italian, Chinese, Mexican, etc.), fast food, fine dining, steakhouses
cafes_and_light_fare	Coffee shops, tea houses, cafes, bagel/donut/juice shops
bars_and_nightlife	Bars, pubs, wine bars, night clubs, karaoke
bakeries_and_sweets	Bakeries, candy stores, ice cream shops, chocolate shops
food_retail_and_markets	Grocery stores, supermarkets, delis, butcher shops, convenience stores
food_services	Catering, food courts, food delivery, sandwich shops
lodging_and_accommodation	Hotels, motels, hostels, B&Bs, resorts, inns
shopping_general	Malls, department stores, discount stores, gift shops
shopping_specialty_retail	Book stores, clothing, jewelry, electronics, pet stores, florists
automotive	Car dealers, repair, rental, car wash, gas stations, EV charging
health_and_medical	Hospitals, doctors, dentists, chiropractors, pharmacies
beauty_and_personal_care	Salons, barber shops, spas, nail salons, wellness centers
fitness_and_sports	Gyms, sports clubs, swimming pools, yoga studios, bowling alleys
parks_and_nature	Parks, gardens, beaches, hiking areas, wildlife parks
entertainment_and_attractions	Amusement parks, zoos, aquariums, movie theaters, casinos
arts_and_culture	Museums, art galleries, cultural centers, historical landmarks
performing_arts_and_venues	Theaters, concert halls, arenas, stadiums, event venues
religious_sites	Churches, mosques, synagogues, temples
education	Schools, universities, preschools, camps
government_and_civic	City hall, courthouses, post offices, police/fire stations
financial_services	Banks, ATMs, accounting firms, insurance agencies
professional_services	Lawyers, consultants, real estate agencies
home_services_and_contractors	Electricians, plumbers, locksmiths, hardware stores, moving companies
transportation	Airports, train stations, bus stops, subway stations, ferry terminals
travel_and_tourism	Travel agencies, tour operators, visitor centers
residential	Apartment buildings, condos, housing complexes
geographic_administrative	Countries, states, cities, postal codes
outdoor_recreation	Campgrounds, RV parks, farms, ski resorts
community_and_social	Community centers, libraries, public baths
miscellaneous_services	Laundry, tailors, courier services, veterinary care

Common Workflows

Find and locate a business type:

Use nearby_search with a category to find businesses near a location
Use geocode to get exact coordinates for any address from the results

Identify what is at a location:

Use reverse_geocode with coordinates to get the address
Use nearby_search with those coordinates to discover surrounding businesses

Search and filter:

Use text_search with a descriptive query for broad results
Use nearby_search with included_types for category-specific filtered results

Important Notes

For nearby_search, you must provide either an address or both latitude and longitude. If you provide an address, it is automatically geocoded to coordinates.
For text_search, location parameters are optional and serve as a bias (not a strict boundary).
The included_types and excluded_types parameters only apply to nearby_search. They do not work with text_search.
Maximum search radius is 50,000 meters (50 km).
Maximum results per request is 50.

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Call the AgentPMT-Tool-Search-and-Execution tool with action 'get_schema' and tool_id 695e8470c309cf48479329e4 ("Local Business Discovery and Mapping"). Then call the same tool with action 'call_tool', tool_id 695e8470c309cf48479329e4, and the parameters needed for my request.

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

Local Business Discovery and Mapping

Available ActionsEach successful request consumes credits as outlined below.

Details

Use Cases

Actions(4)

Connect Your Agent In 5 Min

Hosted Streamable HTTPS

Local STDIO Fallback

Credit-Based Access Using AgentAddress

Direct x402 Payment

Usage Instructions

Local Business Discovery and Mapping

Actions

nearby_search

text_search

geocode

reverse_geocode

Category Groups

Common Workflows

Important Notes

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

Looking for help integrating AI into your business? Set up a free consultation.