Skip to main content
Glama

Google Maps MCP

Get Google Maps Reviews (SerpAPI)

google_maps_reviews

Fetch the reviews of a Google Maps place via SerpAPI. Provide exactly one of place_id, data_id or data_cid — all come from google_maps_search or google_local_search results. A digit-only id (the place_id that google_local_search returns is a Google CID) is accepted in any of the three fields and resolved to the Maps data_id automatically via one place lookup. Returns reviews (author, rating, text, date) plus the topics you can filter by. Paginate with next_page_token from the previous response.

Input Schema

NameRequiredDescriptionDefault
hlNoLanguage code, e.g. 'en', 'es', 'fr', 'pt-br'.
numNoNumber of reviews per page, 1-20 — only honoured together with next_page_token, topic_id or query; the initial page always returns 8 and the parameter is dropped there.
queryNoFilter/search reviews by free text. Mutually exclusive with topic_id.
data_idNoGoogle Maps data_id of the place ('0x…:0x…' from google_maps_search). Provide exactly one of place_id, data_id or data_cid.
sort_byNoReview sort order: 'qualityScore' (most relevant, default), 'newestFirst', 'ratingHigh', 'ratingLow'.
data_cidNoGoogle CID of the place — the digit-only `place_id` google_local_search returns. Resolved to the Maps data_id via one place lookup. Provide exactly one of place_id, data_id or data_cid.
no_cacheNoForce a fresh SerpAPI fetch and bypass this server's result cache. Default false.
place_idNoGoogle Maps place_id of the place ('ChIJ…' from google_maps_search). A digit-only value is treated as a Google CID and resolved automatically. Provide exactly one of place_id, data_id or data_cid.
topic_idNoFilter reviews by a topic id (from a prior response). Mutually exclusive with query.
zero_traceNoEnterprise-only ZeroTrace mode: don't store search params/metadata on SerpAPI. Default false.
next_page_tokenNoPagination token from the previous response, to fetch the next page of reviews.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden, and it does disclose non-obvious behavior: a digit-only id triggers an extra place lookup before the review fetch, and results are paginated with a token from the prior response. It does not mention caching, rate limits, or quota cost, which keeps it short of a 5 for an unannotated tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four sentences, front-loaded with the purpose, then identifiers, then return shape, then pagination. Every sentence adds a distinct decision-relevant fact with no repetition of the schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 11 parameters, no output schema, and no annotations, the description supplies exactly the missing pieces: where identifiers come from, what the response contains (author, rating, text, date, topics), and how to continue paginating. Nothing an agent needs to call it correctly is absent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description earns an extra point by adding cross-field semantics that the schema states only piecemeal — that a digit-only value is accepted in any of the three id fields and resolved automatically. The remaining parameters (hl, sort_by, no_cache, zero_trace) are adequately covered by their schema descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Fetch the reviews of a Google Maps place via SerpAPI') and immediately distinguishes itself from google_maps_search / google_local_search by naming them as the source of identifiers rather than substitutes. An agent can route between the three siblings without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Clearly states the prerequisite ('all come from google_maps_search or google_local_search results') and the selection rule (provide exactly one of place_id/data_id/data_cid), plus the pagination path via next_page_token. It does not explicitly state when to avoid this tool, but the sibling relationship is unambiguous enough that the gap is small.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources