Skip to main content
Glama

Get local SERP results

get_local_serp_results
Read-only

Fetches one Google Maps or Local Finder SERP near a coordinate. Returns provider rows with rank fields intact; callers decide how to match a target business.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
nearYesCoordinate (and optional map zoom) the SERP is fetched from.
depthNoNumber of results to fetch (1-100). Defaults to 20.
deviceNoDevice the SERP is rendered for. Defaults to desktop.
keywordYesSearch query to run on Google Maps or Local Finder.
projectIdYesRequired. The HarborRank project ID to scope this call to. Get one from list_projects.
searchTypeNoWhich local SERP to fetch. Defaults to maps.
languageCodeNoLanguage code (e.g. 'en', 'es', 'vi'). Defaults to the project's default market language (see list_projects).

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
metaNo
resultsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.4/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true, destructiveHint=false, and openWorldHint=true, so the safety profile is covered. The description adds that rank fields are returned intact and that business matching is left to the caller, which is useful context beyond the annotations, but it omits rate limits, pagination/result ordering, and any cost or quota behavior for a live SERP fetch.

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?

Two sentences, no filler, with the core purpose front-loaded and the output-handling caveat second. Every clause carries information.

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

Completeness4/5

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

With an output schema present and 100% parameter coverage, the description need not explain return shapes; it correctly focuses on purpose and the caller-matching contract. It is only slightly short of complete because it gives no guidance on choosing searchType/device/zoom tradeoffs or on sibling selection.

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

Parameters3/5

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

Schema description coverage is 100%, so every parameter including nested latitude/longitude/zoom and the searchType enum is already documented. The description only echoes 'near a coordinate' and 'Google Maps or Local Finder' without adding format or default semantics, so baseline 3 applies.

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

Purpose4/5

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

States a specific verb ('Fetches') and resource ('one Google Maps or Local Finder SERP near a coordinate'), and scopes it to a single SERP. It implicitly separates itself from the non-local get_serp_results and from search_local_businesses, but never names those siblings explicitly.

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

Usage Guidelines2/5

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

No when-to-use guidance is given: nothing says when to prefer this over get_serp_results, search_local_businesses, or find_serp_competitors, and no prerequisites or exclusions are stated. The only hint is the closing note that callers do their own business matching, which is about output handling rather than tool selection.

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.