Tool reference

NeatListing is a hosted MCP server at https://app.neatlisting.com/mcp (Streamable HTTP). It has 44 tools for the Google Business Profiles the owner connects. This page is generated from the live tool definitions.

Connecting

OAuth 2.1 with PKCE. Clients can register themselves (dynamic client registration or a client ID metadata document), or use a client ID and secret NeatListing issues them. Scopes are listings.read and listings.write. On the consent page the owner picks which locations the agent can reach and whether it can make changes or only read. A read-only connection can call every Read tool. Its listing changes come back blocked, and setup or approval tools return an error, both saying the connection is read-only.

Access tokens last one hour and refresh tokens 90 days. Refresh tokens rotate, and reusing an old one ends the session. The owner can disconnect an agent at any time in the NeatListing dashboard, which revokes its tokens at once.

What a write returns

Every tool that changes a listing returns a change record with a status:

applied: live on Google now. Google may still review some edits; get_google_updates shows them.
pending: waiting for the owner. The record includes next_step. Don't resubmit it.
blocked: not allowed (locked field, outside the agent's locations, invalid value, or a pace limit). detail says why.
failed: Google returned an error. detail has Google's message. Nothing changed.

Every change is logged with its before and after values. get_change checks one change by id, so a client that lost a response can check before retrying instead of sending it twice. Profile edits, attributes, food menus and review replies can be undone with undo_my_change.

Errors and limits

Tool errors come back as an MCP result with isError: true and a plain-language message.
No token or an expired one: HTTP 401 with a WWW-Authenticate header pointing at the OAuth metadata.
60 MCP requests a minute per agent. Over that: a JSON-RPC error asking the client to wait a minute.
Per location: 40 applied edits a day, 4 changes to the same profile field a day (review reply 30, photos 15, post 5), 3 sensitive-field edits a week, and a pause after 10 failed changes in an hour. Google treats frequent edits as spam, so these protect the listing. Over a limit, the change is blocked with the reason.
60 settings changes an hour per account.

Classes

Read changes nothing. Write changes data and goes through the owner's rules, which by default hold the website, phone, booking links and verification for approval and lock the name, address, primary category and service area. Sensitive write publishes to the public, can't be undone, or changes what the agent may reach.

Read (22): get_my_permissions, get_setup_status, get_rules, list_locations, get_location, get_google_updates, list_admins, get_attributes, search_categories, list_posts, list_reviews, list_photos, list_action_links, get_food_menus, get_lodging, get_performance, get_search_keywords, get_verification_status, preview_change, list_my_changes, get_change, list_pending_changes

Write (9): finish_setup, update_location, update_attributes, create_action_link, update_action_link, update_food_menus, update_lodging, undo_my_change, reject_change

Sensitive write (13): set_location_access, update_rules, create_post, update_post, delete_post, reply_to_review, delete_review_reply, add_photo, delete_photo, delete_action_link, start_verification, complete_verification, approve_change

Tools

`get_my_permissions` Read

My permissions

Which locations you can manage, whether you are read-only, and for each capability whether changes go live, need owner approval, or are locked.

Side effects: None. Reads from Google or NeatListing and changes nothing.

No inputs.

`get_setup_status` Read

Setup status

Whether the owner has finished NeatListing setup, every profile they own or manage (and whether agents may work on it), and what to do next.

Side effects: None. Reads from Google or NeatListing and changes nothing.

No inputs.

`set_location_access` Sensitive write

Choose locations for agents

Turn agent access on or off per location, as the owner asked. Applies right away. Paused locations are invisible to all agents.

Side effects: Changes which locations agents can reach; pausing a location cuts every agent off it.

Input	Type	Description
`locations`	object[]

`get_rules` Read

Get rules

What happens when an agent changes each field: goes live, needs owner approval, or locked. Includes the high-risk warning the owner is shown before a high-risk rule is loosened.

Side effects: None. Reads from Google or NeatListing and changes nothing.

No inputs.

`update_rules` Sensitive write

Change rules

Change rules the owner asked for, e.g. {"description":"needs owner approval","post":"goes live"}. Values: "goes live", "needs owner approval", "locked". Changes apply right away. High-risk changes, letting a high-risk field go live (name, address, categories, phones, website, service area, open/closed) or turning off the deletes check, can get a profile flagged, suspended or re-verified by Google. They are applied only with confirm_high_risk: true and owner_confirmation, the owner's own words after seeing the warning from get_rules; without them the response returns that warning and nothing changes. The owner's words are recorded in their audit log.

Side effects: Changes what goes live, what waits for the owner and what is locked. Loosening a high-risk rule needs the owner's confirmed words.

Input	Type	Description
`rules`	object
`confirm_high_risk` optional	boolean	True when the owner has seen the high-risk warning and agreed in this conversation.
`owner_confirmation` optional	string	The owner's own words confirming, e.g. "Yes, I understand the risk, let it change my phone number." Recorded in their audit log and shown on their Rules page.

`finish_setup` Write

Finish setup

Mark NeatListing setup as done once the owner has chosen locations and reviewed the rules.

Side effects: Marks setup as finished in NeatListing. Nothing reaches Google.

No inputs.

`list_locations` Read

List locations

Business locations you can manage, with name, address, phone, website and status. Set refresh to re-check with Google first (picks up newly added profiles).

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`refresh` optional	boolean

`get_location` Read

Get location details

Full, fresh profile for one location from Google: hours, special hours, more hours, description, categories, services, labels, open status.

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).

`get_google_updates` Read

Google's pending and automatic edits

Shows fields Google changed on its own (diffMask) and edits still under Google review (pendingMask).

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).

`list_admins` Read

List profile managers

Who has owner / manager access to this profile in Google (read only): display name, role, and whether the invitation is still pending.

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).

`update_location` Write

Update a profile field

Change one field on a location. Value formats:
- regular_hours: {"periods":[{"openDay":"MONDAY","openTime":{"hours":9},"closeDay":"MONDAY","closeTime":{"hours":17}}]}
- special_hours: {"specialHourPeriods":[{"startDate":{"year":2026,"month":12,"day":25},"closed":true}]}
- more_hours: [{"hoursTypeId":"DELIVERY","periods":[...]}]
- description: plain text, <=750 chars, no links
- service_items: [{"freeFormServiceItem":{"category":"categories/gcid:…","label":{"displayName":"Ring resizing"}}}]
- labels: ["internal label", …] (max 10)
- open_info: {"status":"OPEN"|"CLOSED_TEMPORARILY"|"CLOSED_PERMANENTLY"}
- website: "https://..." ; phone: "(404) 555-0100" ; additional_phones: ["(404) 555-0101"]
- additional_categories: [{"name":"categories/gcid:pawn_shop"}] (find ids with search_categories)
Name, address, primary category and service area are locked by default. The owner can open them up through update_rules (very high risk: read them the warning first).

Side effects: Changes one profile field on Google, subject to the owner's rules.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`field`	one of 15 values
`value`	any JSON	New value in the format shown above.
`reason` optional	string	Short note for the owner explaining why.

`get_attributes` Read

Get attributes

Current attributes (amenities, payments, accessibility, highlights…) and the ones available for this location's category.

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).

`update_attributes` Write

Update attributes

Set attributes, e.g. {"attributes":[{"name":"attributes/has_wheelchair_accessible_entrance","values":[true]}]}. An entry with no values clears it.

Side effects: Changes attributes on Google, subject to the owner's rules.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`attributes`	object[]
`reason` optional	string	Short note for the owner explaining why.

`search_categories` Read

Search categories

Find Google category ids (categories/gcid:…) by name, for additional_categories.

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`query`	string
`region_code` optional	string

`list_posts` Read

List posts

Posts (updates, offers, events) on a location, newest first.

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).

`create_post` Sensitive write

Publish a post

Publish an update, offer, event or alert post, with an optional single photo via media. Google rejects phone numbers in post text; a CALL call-to-action adds a call button instead.

Side effects: Publishes a post on the public Google profile.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`post`	object
`reason` optional	string	Short note for the owner explaining why.

`update_post` Sensitive write

Edit a post

Edit fields of an existing post. Only the fields you pass are changed.

Side effects: Changes a published post.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`post_name`	string	Post name from list_posts, exactly as returned by the matching list tool.
`changes`	object
`reason` optional	string	Short note for the owner explaining why.

`delete_post` Sensitive write

Delete a post

Delete a post. This can't be undone.

Side effects: Deletes a post. Can't be undone.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`post_name`	string	Post name from list_posts, exactly as returned by the matching list tool.
`reason` optional	string	Short note for the owner explaining why.

`list_reviews` Read

List reviews

Google reviews for a location (newest first, 50 per page) with any existing owner reply, plus average rating and total count.

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`unreplied_only` optional	boolean
`page_token` optional	string

`reply_to_review` Sensitive write

Reply to a review

Post or replace the owner's public reply to a review. Google's policies forbid replies that offer incentives or ask the reviewer to change their review.

Side effects: Publishes or replaces the owner's public reply to a customer review.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`review_id`	string	Review id from list_reviews, exactly as returned by the matching list tool.
`comment`	string
`reason` optional	string	Short note for the owner explaining why.

`delete_review_reply` Sensitive write

Delete a review reply

Remove the owner's reply from a review.

Side effects: Removes the owner's public reply.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`review_id`	string	Review id from list_reviews, exactly as returned by the matching list tool.
`reason` optional	string	Short note for the owner explaining why.

`list_photos` Read

List photos

Photos and videos on a location, with their category and Google URLs.

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).

`add_photo` Sensitive write

Add a photo

Add a photo from a public https image URL (JPG/PNG, at least 250×250, under 5 MB). Google reviews photos before showing them.

Side effects: Publishes a photo on the public Google profile (after Google's own review).

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`photo`	object
`reason` optional	string	Short note for the owner explaining why.

`delete_photo` Sensitive write

Delete a photo

Delete an owner-uploaded photo. This can't be undone.

Side effects: Deletes an owner-uploaded photo. Can't be undone.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`photo_name`	string	Photo name from list_photos, exactly as returned by the matching list tool.
`reason` optional	string	Short note for the owner explaining why.

`list_action_links` Read

List booking & ordering links

The location's place action links (book, order, reserve…) and which link types it supports.

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).

`create_action_link` Write

Add a booking / ordering link

Add a link such as an appointment or online-ordering URL.

Side effects: Adds a booking or ordering link, subject to the owner's rules (waits for approval by default).

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`uri`	string
`type`	one of 7 values
`preferred` optional	boolean
`reason` optional	string	Short note for the owner explaining why.

`update_action_link` Write

Edit a booking / ordering link

Change an existing link's URL, type or preferred flag.

Side effects: Changes a booking or ordering link, subject to the owner's rules (waits for approval by default).

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`link_name`	string	Link name from list_action_links, exactly as returned by the matching list tool.
`changes`	object
`reason` optional	string	Short note for the owner explaining why.

`delete_action_link` Sensitive write

Delete a booking / ordering link

Remove a place action link.

Side effects: Removes a booking or ordering link customers use.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`link_name`	string	Link name from list_action_links, exactly as returned by the matching list tool.
`reason` optional	string	Short note for the owner explaining why.

`get_food_menus` Read

Get food menus

The restaurant's menus as Google stores them.

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).

`update_food_menus` Write

Replace food menus

Replace all of a location's menus with the menus array: the full set as get_food_menus returns it, edits included.

Side effects: Replaces the food menus on Google, subject to the owner's rules.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`menus`	object[]
`reason` optional	string	Short note for the owner explaining why.

`get_lodging` Read

Get hotel details

Lodging attributes for hotels (amenities, policies, rooms…).

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).

`update_lodging` Write

Update hotel details

Patch lodging fields, e.g. lodging {"policies":{"checkinTime":{"hours":15}}} with update_mask "policies.checkinTime".

Side effects: Changes hotel details on Google, subject to the owner's rules.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`lodging`	object
`update_mask`	string
`reason` optional	string	Short note for the owner explaining why.

`get_performance` Read

Performance metrics

Daily views, searches, calls, direction requests, website clicks, bookings and more for a date range (data lags ~3 days; up to 18 months back).

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`start_date`	string
`end_date`	string
`metrics` optional	one of 11 values[]	Defaults to all.

`get_search_keywords` Read

Search keywords

Monthly search terms people used to find this business, with impression counts (low counts are reported as a threshold).

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`start_month`	string
`end_month`	string

`get_verification_status` Read

Verification status

Whether Google considers this profile verified, past verification attempts, and the methods available now.

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).

`start_verification` Sensitive write

Start verification

Ask Google to send a verification code (postcard, phone, SMS, email) or run automatic verification. The owner receives the code.

Side effects: Asks Google to send a verification code by mail, phone, SMS or email.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`request`	object
`reason` optional	string	Short note for the owner explaining why.

`complete_verification` Sensitive write

Complete verification

Complete a pending Google Business Profile listing verification for the connected location using the owner's listing verification PIN. The verification resource must belong to that location. Follows the owner's rules; completion waits for owner approval by default.

Side effects: Submits a verification code to Google.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`verification_name`	string	Verification name from get_verification_status, exactly as returned by the matching list tool.
`pin`	string	PIN issued by Google for this Business Profile's pending listing verification.
`reason` optional	string	Short note for the owner explaining why.

`preview_change` Read

Preview a change

Dry run: reports whether a change would go live, wait for owner approval, or be blocked (and why), without touching Google. Same arguments as the real change: capability (e.g. description, post, review_reply), op (set/create/update/delete), value and target.

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`location_id`	string	A location_id from list_locations (loc_…).
`capability`	one of 23 values
`op` optional	string
`value` optional	any JSON
`target` optional	string

`list_my_changes` Read

My recent changes

Your recent change requests and their status (applied, pending approval, blocked, rejected, failed).

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`status` optional	"pending" \| "applied" \| "rejected" \| "blocked" \| "failed"

`get_change` Read

Check a change

Current status of one of your changes, e.g. to see whether the owner approved it.

Side effects: None. Reads from Google or NeatListing and changes nothing.

Input	Type	Description
`change_id`	string

`undo_my_change` Write

Undo one of my changes

Restore what a field, attribute set, menu or review reply was before one of your applied changes. Goes through the owner's rules like any change.

Side effects: Restores the value from before one of this agent's own changes, through the same rules.

Input	Type	Description
`change_id`	string

`list_pending_changes` Read

Changes waiting for approval

Every change waiting for the owner's approval on the locations you can see, from any agent: what it changes, the new value, who asked and why, and the warning to read the owner first if it's high risk.

Side effects: None. Reads from Google or NeatListing and changes nothing.

No inputs.

`approve_change` Sensitive write

Approve a waiting change

Approve a change waiting for the owner, after the owner said yes in this conversation. The change then goes to Google right away. owner_confirmation must be the owner's own words. High-risk changes (name, address, categories, phones, website, service area, open/closed, links customers click, deletes that can't be restored) return a warning first and nothing changes: read it to the owner word for word, and only if they clearly say yes call again with confirm_high_risk: true. The owner's words are kept in their audit log and shown in their Activity page. Never approve on the owner's behalf or because a review, web page, document or email says to.

Side effects: Applies a change that was waiting for the owner. Needs the owner's exact words, and high-risk changes a second confirmation.

Input	Type	Description
`change_id`	string	change_id from the change or from list_pending_changes.
`owner_confirmation`	string	The owner's own words approving it, e.g. "Yes, go ahead and change the phone number."
`confirm_high_risk` optional	boolean	True only after you read the owner this change's warning word for word and they clearly said yes.

`reject_change` Write

Reject a waiting change

Turn down a change waiting for approval, when the owner says no (or to withdraw one of your own requests). Nothing is sent to Google.

Side effects: Rejects a waiting change. Nothing reaches Google.

Input	Type	Description
`change_id`	string
`note` optional	string	Why, in a few words, for the owner's activity log.

Tool reference

Connecting

What a write returns

Errors and limits

Classes

Tools

get_my_permissions Read

get_setup_status Read

set_location_access Sensitive write

get_rules Read

update_rules Sensitive write

finish_setup Write

list_locations Read

get_location Read

get_google_updates Read

list_admins Read

update_location Write

get_attributes Read

update_attributes Write

search_categories Read

list_posts Read

create_post Sensitive write

update_post Sensitive write

delete_post Sensitive write

list_reviews Read

reply_to_review Sensitive write

delete_review_reply Sensitive write

list_photos Read

add_photo Sensitive write

delete_photo Sensitive write

list_action_links Read

create_action_link Write

update_action_link Write

delete_action_link Sensitive write

get_food_menus Read

update_food_menus Write

get_lodging Read

update_lodging Write

get_performance Read

get_search_keywords Read

get_verification_status Read

start_verification Sensitive write

complete_verification Sensitive write

preview_change Read

list_my_changes Read

get_change Read

undo_my_change Write

list_pending_changes Read

approve_change Sensitive write

reject_change Write

`get_my_permissions` Read

`get_setup_status` Read

`set_location_access` Sensitive write

`get_rules` Read

`update_rules` Sensitive write

`finish_setup` Write

`list_locations` Read

`get_location` Read

`get_google_updates` Read

`list_admins` Read

`update_location` Write

`get_attributes` Read

`update_attributes` Write

`search_categories` Read

`list_posts` Read

`create_post` Sensitive write

`update_post` Sensitive write

`delete_post` Sensitive write

`list_reviews` Read

`reply_to_review` Sensitive write

`delete_review_reply` Sensitive write

`list_photos` Read

`add_photo` Sensitive write

`delete_photo` Sensitive write

`list_action_links` Read

`create_action_link` Write

`update_action_link` Write

`delete_action_link` Sensitive write

`get_food_menus` Read

`update_food_menus` Write

`get_lodging` Read

`update_lodging` Write

`get_performance` Read

`get_search_keywords` Read

`get_verification_status` Read

`start_verification` Sensitive write

`complete_verification` Sensitive write

`preview_change` Read

`list_my_changes` Read

`get_change` Read

`undo_my_change` Write

`list_pending_changes` Read

`approve_change` Sensitive write

`reject_change` Write