google_maps_business_search
Local businesses from a Maps search — name, address, phone, website, rating, hours, place id. Flat 2 credits. Add enrich=contacts for role emails and socials from each website. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"q": "<q>"
},
"name": "google_maps_business_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Keyword, for example plumber or coffee. Min 2 characters. | |
| cache | No | Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. | |
| limit | No | Max businesses to return (default 20, max 100). Not a page cursor — there is no next page. Flat 2 credits per call; zero businesses is 0 credits. | |
| enrich | No | Set to contacts to add a contacts object (role emails, E.164 phones, social profiles, contactPageUrl, blockedByRobots) to each business that has a website. limit is at most 50 with enrich=contacts. +1 credit per distinct domain where contacts are found; 0 for the rest. Omit for the plain search. | |
| fields | No | Optional comma-separated keys to keep on each result row (or on the object for single-item tools), e.g. id,url,publishedAt,engagement. Pagination keys are always kept. Does not change the price. | |
| compact | No | Default true here: drop signed media URLs (video, image, avatar links and their expiry stamps) to keep the response small. Ids, permalinks, dates, text and metrics stay. On Threads, Facebook, Meta Ad Library and TikTok Shop tools request timings are dropped too. Pass false for the full body. | |
| language | No | Language code, for example en. Default en. | |
| location | No | Place name: City, Country or City, Region, Country — for example Austin, TX, Istanbul, Turkey, Paris, France, or a country such as Germany. Case, accents, US state codes, and country aliases (USA, UK, Turkey) are handled. A city name shared by several places (Paris) returns 400 with suggestions. When set, the locationCode parameter is ignored. | |
| locationCode | No | Numeric place code, used only when location is omitted. Default 2840 (United States). |