Business Profile tools
Locations, reviews and replies, posts, media, category and info updates, performance insights.
Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.
Read tools11 tools
list_gbp_locations
קריאה1 creditsGoogle Business Profile locations (title, phone, website, hours, category, address, description) with a missing-info audit per location. Read only.
This tool takes no parameters.
list_gbp_reviews
קריאה1 creditsReviews of one or all locations for the last N days (rating, text, reply status) plus average rating. Read only.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or location title |
daysOptional | integer (1–365) | — |
min_ratingOptional | integer (1–5) | — |
max_ratingOptional | integer (1–5) | — |
unreplied_onlyOptional | boolean | — |
limitOptional | integer (1–200) | reviews read per location (default 50) |
summary_onlyOptional | boolean | only average rating, total and unanswered count |
offsetOptional | integer (0–…) | skip this many matching reviews per location |
draft_gbp_review_replies
קריאה2 creditsDraft polite replies for unanswered reviews at or below max_rating (default 3 stars). Nothing is published; show drafts to the user and call reply_gbp_review for the ones they pick.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or location title |
daysOptional | integer (1–365) | — |
max_ratingOptional | integer (1–5) | — |
toneOptional | string | e.g. 'kısa, resmi, özür dileyen' |
gbp_insights
קריאה1 creditsListing insights for the period: impressions (search/maps), website clicks, calls, direction requests, conversations, bookings; per location and totals. Read only.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or location title |
daysOptional | integer (1–540) | — |
dailyOptional | boolean | — |
gbp_vs_ads
קריאה3 creditsSide-by-side local picture: Business Profile insights, Google Ads local campaign spend/clicks/conversions and Search Console organic clicks (city queries). Each source reports honestly if not connected. Read only.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or location title |
cityOptional | string | — |
daysOptional | integer (1–540) | — |
list_gbp_media
קריאה1 creditsPhotos and videos on one or all Business Profile locations: placement category (cover, profile, exterior, interior, team…), Google URL, size, views, plus a count per category and the key slots that are empty. Read only.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or location title |
categoryOptional | COVER | PROFILE | EXTERIOR | INTERIOR | PRODUCT | AT_WORK | FOOD_AND_DRINK | MENU | COMMON_AREA | ROOMS | TEAMS | ADDITIONAL | — |
limitOptional | integer (1–500) | — |
gbp_location_details
קריאה1 creditsEverything about one Business Profile location: title, address, phones, website, description, categories, regular hours, the services list, Google Maps link, place id and the direct 'write a review' link. Read only.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or title; omit to use the selected (or only) location |
services_limitOptional | integer (0–500) | — |
gbp_search_categories
קריאה1 creditsSearch Google's Business Profile category list by name (e.g. 'dentist') and get category ids (categories/gcid:…) for update_gbp_categories or gbp_create_location. Read only.
| Parameter | Type | Description |
|---|---|---|
queryRequired | string | — |
regionOptional | string | two-letter country, default TR |
languageOptional | string | — |
limitOptional | integer (1–100) | — |
gbp_search_keywords
קריאה1 creditsSearch terms people used on Google Search and Maps before the listing appeared, with monthly impressions, for a location. Read only.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or title; omit to use the selected (or only) location |
monthsOptional | integer (1–18) | full months back from last month (default 3) |
limitOptional | integer (1–500) | — |
offsetOptional | integer (0–…) | — |
include_low_volumeOptional | boolean | also list terms Google only reports as 'fewer than N' |
gbp_list_posts
קריאה1 creditsLocal posts already published on a Business Profile location, newest first: post id, type, text, state, call-to-action and link. Use the id with gbp_update_post or gbp_delete_post. Read only.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or title; omit to use the selected (or only) location |
limitOptional | integer (1–100) | — |
gbp_verification_options
קריאה1 creditsVerification methods Google offers for a listing (postcard, phone call, SMS, e-mail, instant), past and pending verifications, and whether the account already manages it. Read only.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or title; omit to use the selected (or only) location |
languageOptional | string | — |
Write tools15 tools
update_gbp_location
כתיבה2 creditsUpdate a location's phone and extra phones, website, regular hours, special (holiday) hours, description, title or storefront address (unspecified address parts are kept). Categories are changed with update_gbp_categories. Preview shows field, old and new value; applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
locationRequired | string | location id, locations/ID or location title |
phoneOptional | string | — |
websiteOptional | string | — |
hoursOptional | object | {'pazartesi': '09:00-18:00', 'cumartesi': '10:00-14:00, 15:00-19:00', 'pazar': 'kapalı'} |
special_hoursOptional | array<object> | — |
descriptionOptional | string | — |
titleOptional | string | — |
additional_phonesOptional | array<string> | replaces the extra numbers (max 2); changing only phone keeps them |
clear_additional_phonesOptional | boolean | — |
address_linesOptional | array<string> | — |
cityOptional | string | — |
regionOptional | string | province / state |
postal_codeOptional | string | — |
countryOptional | string | two-letter country code, e.g. TR |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
reply_gbp_review
כתיבה2 creditsPublish a reply to a review (text the user dictated or approved from draft_gbp_review_replies). Posted directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
locationRequired | string | location id, locations/ID or location title |
review_idRequired | string | — |
replyRequired | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_gbp_post
כתיבה2 creditsPublish a Business Profile post (update, event, offer or alert) to all or selected locations. Posted directly when the user asks; the result shows what was posted.
| Parameter | Type | Description |
|---|---|---|
summaryRequired | string | — |
topic_typeOptional | STANDARD | EVENT | OFFER | ALERT | — |
cta_typeOptional | BOOK | ORDER | SHOP | LEARN_MORE | SIGN_UP | CALL | — |
cta_urlOptional | string | — |
image_urlOptional | string | — |
locationsOptional | array<string> | omit for all locations |
languageOptional | string | — |
event_titleOptional | string | — |
start_dateOptional | string | — |
end_dateOptional | string | — |
coupon_codeOptional | string | — |
termsOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_gbp_categories
כתיבה2 creditsChange a location's primary and/or additional categories. Names are resolved against Google's category list (ambiguous names return the candidates instead of guessing). Preview shows old and new categories; applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
locationRequired | string | location id, locations/ID or location title |
primary_categoryOptional | string | category display name (e.g. 'Diş kliniği') or categories/gcid:… id |
additional_categoriesOptional | array<string> | replaces all additional categories (max 9) |
add_categoriesOptional | array<string> | — |
remove_categoriesOptional | array<string> | — |
regionOptional | string | two-letter country for the category list, default TR |
languageOptional | string | category names language, default the user's |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
upload_gbp_media
כתיבה2 creditsAdd one or several photos or videos (source_url / source_urls) from public URLs to one or more Business Profile locations with a placement category (cover, profile, exterior, interior, product, team…). Uploaded directly when the user asks; the result shows what was added.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or location title |
locationsOptional | array<string> | several locations at once |
source_urlOptional | string | public http(s) URL of the photo/video; Google downloads it |
source_urlsOptional | array<string> | several photos/videos in one call |
media_formatOptional | PHOTO | VIDEO | — |
categoryOptional | COVER | PROFILE | EXTERIOR | INTERIOR | PRODUCT | AT_WORK | FOOD_AND_DRINK | MENU | COMMON_AREA | ROOMS | TEAMS | ADDITIONAL | placement; COVER and PROFILE must be photos |
descriptionOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
connect_business_profile
כתיבה0 creditsStart connecting Google Business Profile: returns a one-time authorisation link the user opens (same flow as connect_account). Nothing is connected until the user signs in.
This tool takes no parameters.
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
gbp_create_location
כתיבה5 creditsCreate a NEW Business Profile listing (a new business on Maps/Search). Created directly when the user asks (the result shows the listing) and still needs verification (gbp_verification_options) before it appears.
| Parameter | Type | Description |
|---|---|---|
titleRequired | string | — |
address_linesRequired | array<string> | — |
cityOptional | string | — |
regionOptional | string | — |
postal_codeOptional | string | — |
countryRequired | string | two-letter country code, e.g. TR |
primary_categoryRequired | string | category name or categories/gcid:… (gbp_search_categories) |
phoneOptional | string | — |
websiteOptional | string | — |
hoursOptional | object | {'pazartesi': '09:00-18:00', 'pazar': 'kapalı'} |
descriptionOptional | string | — |
accountOptional | string | Business Profile account; default the connected one |
languageOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
gbp_start_verification
כתיבה3 creditsStart verifying a listing with one of the methods from gbp_verification_options. Approval item; Google then sends a code, entered with gbp_complete_verification.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or title; omit to use the selected (or only) location |
methodRequired | ADDRESS | EMAIL | PHONE_CALL | SMS | AUTO | — |
phoneOptional | string | for PHONE_CALL / SMS |
emailOptional | string | for EMAIL |
mailer_contactOptional | string | recipient name for the postcard (ADDRESS) |
languageOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
gbp_complete_verification
כתיבה2 creditsComplete a pending verification with the PIN Google sent (postcard, SMS, call or e-mail). Approval item; the PIN is masked in the preview.
| Parameter | Type | Description |
|---|---|---|
verificationRequired | string | verification name locations/…/verifications/… or its id |
pinRequired | string | — |
locationOptional | string | location id, locations/ID or title; omit to use the selected (or only) location |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
gbp_manage_services
כתיבה3 creditsAdd, remove or replace services in a location's Services list (free-form name or Google's predefined service id, with optional description and price). Preview shows the old and new list; applied directly when the user asks. The current list is in gbp_location_details.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or title; omit to use the selected (or only) location |
actionRequired | add | remove | replace | — |
servicesRequired | array<object> | — |
languageOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
gbp_social_links
כתיבה2 creditsRead or set the social media and appointment links on a Business Profile (Instagram, Facebook, X, LinkedIn, YouTube, TikTok, Pinterest, WhatsApp, appointment). Without links/remove it only reads; changes are applied directly and the result shows old and new links.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or title; omit to use the selected (or only) location |
linksOptional | object | {platform: url}; platforms: instagram, facebook, twitter, linkedin, youtube, tiktok, pinterest, whatsapp, appointment |
removeOptional | array<string> | platforms whose link is removed |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
gbp_update_post
כתיבה3 creditsEdit an already published Business Profile post in place (text and/or call-to-action button) without deleting it. Applied directly when the user asks; the result shows before → after.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or title; omit to use the selected (or only) location |
postRequired | string | post id or full name from gbp_list_posts |
summaryOptional | string | — |
cta_typeOptional | BOOK | ORDER | SHOP | LEARN_MORE | SIGN_UP | CALL | — |
cta_urlOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
gbp_delete_post
כתיבהIrreversible2 creditsPERMANENTLY delete a Business Profile post. Only call it when the user explicitly asked for it; it is applied at once and cannot be undone.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or title; omit to use the selected (or only) location |
postRequired | string | post id or full name from gbp_list_posts |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
gbp_update_photo_category
כתיבה2 creditsMove a photo already on the profile to another placement category (cover, profile, exterior, interior…) in place, keeping its views and history. Applied directly when the user asks; the result shows before → after.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or title; omit to use the selected (or only) location |
media_idRequired | string | media_key from list_gbp_media |
categoryRequired | COVER | PROFILE | EXTERIOR | INTERIOR | PRODUCT | AT_WORK | FOOD_AND_DRINK | MENU | COMMON_AREA | ROOMS | TEAMS | ADDITIONAL | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
gbp_delete_photo
כתיבהIrreversible2 creditsPERMANENTLY delete a photo or video from a Business Profile. Only call it when the user explicitly asked for it; it is applied at once and cannot be undone.
| Parameter | Type | Description |
|---|---|---|
locationOptional | string | location id, locations/ID or title; omit to use the selected (or only) location |
media_idRequired | string | media_key from list_gbp_media |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.