Skip to main content
Glama

Google Search

social_google_search
Read-only

Performs a Google search and returns organic results with url, title, and description for each result. Supports an optional region parameter (2-letter country code) to get localized results from a specific country. Pages 1 through 11 are supported; requests for page 12 or greater return a 400 response. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Google Search API View Pricing Search Google 1 credit per request Actual supplier units are reported per request. Examples are not guaranteed prices.

Input Schema

NameRequiredDescriptionDefault
pageNoPage number to retrieve. Must be between 1 and 11; page 12 or greater returns a 400 response.
queryYesSearch query
regionNo2 letter country code, ie US, UK, CA, etc This will show results from that country
date_postedNoDate posted

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

B3.2/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 genuinely useful behavior beyond that: the page-11 cutoff with a 400 response and the credit cost/purchase-on-repeat warning. However, the pricing passage is garbled and self-conflicting ('at least 10 Nexscope credits' vs '1 credit per request'), which weakens the disclosure rather than clarifying it.

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

Conciseness4/5

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

The useful content is front-loaded: what it returns, then region, then page limits, then cost. The tail end ('Google Search API View Pricing Search Google 1 credit per request Actual supplier units are reported per request. Examples are not guaranteed prices.') is scraped boilerplate that repeats and muddles the earlier credit statement rather than earning its place.

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

Completeness3/5

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

With no output schema, the description correctly steps in to describe the shape of results, and it covers error behavior and cost. It is still incomplete for a 4-parameter search tool: the date_posted filter goes unmentioned and result-count/truncation behavior is never stated.

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 the schema already documents page, region, query and date_posted. The description restates region localization and the page limit but adds no format or semantic detail the schema lacks, and it never mentions the date_posted filter at all. Baseline 3 is appropriate when the schema carries the parameter burden.

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?

The first sentence names a concrete verb and resource ('Performs a Google search') and even enumerates the returned fields (url, title, description), which is far stronger than a restatement of the name. It does not, however, differentiate itself from nearby siblings such as nexscope_web_search, nexscope_google_ai_mode_search, nexscope_seo_serp, or nexscope_data_ai_search_google_search, so an agent must guess which search tool is intended.

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?

There is no explicit when-to-use or when-not-to-use guidance and no named alternative. The description only supplies operational constraints (region is optional, page 12+ returns 400), which tells the agent how to call it but not when to prefer it over the many other search-family siblings.

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.