Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SERPER_LIVE_TOKENYesAPI token from https://serper.live/account/tokens. Required for searches; without it `list_countries` still works.
SERPER_LIVE_API_URLNoAPI base URL, default `https://api.serper.live`https://api.serper.live

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
google_searchA

Run a live Google search for a country, language and device and return the organic results in Google's order: position, title, URL, domain and snippet, plus the questions of Google's "People also ask" block and its related searches. Ads, sitelinks, video and image blocks are left out, so position is the organic rank. Every call is a real, uncached search that usually takes 2–3 seconds and is billed to the Serper.live balance per page of up to 10 results that received results, after the free searches of the account (https://serper.live/pricing); a search that finds nothing costs nothing. Use it to see the whole result list; to check where one site ranks, use domain_position instead.

domain_positionA

Find where a domain ranks in Google's organic results for a keyword, in a country and on a device, right now. Prefer it over google_search when only one site matters: it returns that site's best position and every other position, or a note that the site is outside the checked depth. A subdomain counts as the domain: example.com also matches blog.example.com. Billed like google_search, per page of 10 results of depth that received results (https://serper.live/pricing).

list_countriesA

List the countries Serper.live can search right now, with the default Google interface language of each. Call it when unsure whether a market is open, then pass a returned code as country to google_search or domain_position. Desktop and mobile are available in every market. Free, no token needed.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.7/5.0

Scored across 3 tools

Disambiguation5/5

Each tool has a clearly distinct role: full organic search results, supported-country metadata, and single-domain rank lookup. google_search and domain_position overlap only superficially, and the descriptions explicitly direct the agent to the right tool for each case.

Naming Consistency4/5

All names are snake_case and readable, but the pattern is not fully uniform: list_countries is verb_noun, while google_search and domain_position are noun phrases. This is a minor deviation rather than a source of confusion.

Tool Count5/5

Three tools is well scoped for a focused live-search server, and each tool earns its place by covering search, market discovery, and domain-rank checking. There is no redundant surface area.

Completeness4/5

The core lifecycle for live Google organic search is covered: country availability, full result retrieval, and domain-specific rank checking. Minor gaps exist for adjacent search modes such as news, images, or video, but those are intentionally outside the stated organic-search purpose.

Maintenance

ActivityMaintained
ResponsivenessOutdated data