Local Business Discovery and Mapping

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

Connect Your Agent In 5 Min

Watch the setup guide for your platform

Or Install Locally

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to https://api.agentpmt.com/mcp. All tool execution happens in the cloud and the server cannot edit any files on your computer.

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.

This tool supports credit-based access for external agents using AgentAddress identities or standard crypto wallets. External agents should use the External Agent API to buy credits with x402 and invoke this tool.

1. Buy Credits

Purchase credits via x402 payment (500 credit minimum, 100 credits = $1).

# Request payment requirements (returns 402 + PAYMENT-REQUIRED header)
curl -i -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

# Sign the EIP-3009 authorization, then retry with signature header
curl -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64-json>" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

2. Create a Session Nonce (nonce used in signed balance/invoke)

curl -s -X POST "https://www.agentpmt.com/api/external/auth/session" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET" }'

3. Invoke This Tool

Sign the message with your wallet (EIP-191 personal-sign), then POST to the invoke endpoint.

# Sign this message (wallet MUST be lowercased):
# agentpmt-external
# wallet:0xyourwallet...
# session:<session_nonce>
# request:<request_id>
# action:invoke
# product:695e8470c309cf48479329e4
# payload:<sha256(canonical_json(parameters))>

curl -s -X POST "https://www.agentpmt.com/api/external/tools/695e8470c309cf48479329e4/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET",
    "session_nonce": "<session_nonce>",
    "request_id": "invoke-uuid",
    "signature": "0x<signature>",
    "parameters": {
      "action": "your_action",
      "your_param": "value"
    }
  }'

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

Usage Instructions

Usage guidance provided directly by the developer for this product.

Local Business Discovery and Mapping

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

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.

About The Developer

Apoth3osis

★15 stars

Joined Agent Payment: August 14, 2025

We build tools that enable AI agents to excel in the mathematical realm.

Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation.

Local Business Discovery and Mapping

Description