Log inSubmit server
@serper Live MCP logo

@serper Live MCP

by @serper-live

Live Google organic search, domain rankings, and available country markets through Serper.live.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install @serper Live MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "serper-live-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@serper-live/mcp"
      ],
      "env": {
        "SERPER_LIVE_TOKEN": "YOUR_VALUE_HERE",
        "SERPER_LIVE_API_URL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 3 tools correctly (4d ago).

Overview

@serper-live/mcp connects MCP clients to Serper.live for fresh Google organic search results and ranking checks. Its tools return configurable results by country, language, device, and depth, including domain positions and available markets. Use it for current SERP research, localized rank tracking, or comparing search results across regions. It runs over stdio with npx and requires a Serper.live token for searches.

Use cases

  • Check a domain's Google position in a target country and device
  • Compare localized organic results across two markets
  • Retrieve current search results for an SEO research task
  • Discover which Serper.live markets are available

Key features

  • Live Google organic search results
  • Domain ranking checks by country and device
  • Results for up to 100 positions per call
  • Market and default-language discovery
  • Desktop and mobile search targeting
  • Idempotent billed requests

Tools3

What @serper Live MCP lets your agent do. Expand a tool for its parameters.

Verified live~894 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

What it can do

From the 3 tools this server returned when we ran it; 3 declare their own safety hints.

Handles credentials · 1Makes network requests · 3Read-only tools · 3
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age15 days
Maintainers1

Observed 2026-11-03 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · @serper-live/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads851Package downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed3Callable tools this server registers over MCP.

How @serper Live MCP works

What @serper-live/mcp does

@serper-live/mcp gives AI agents access to live Google organic search data through Serper.live. Search responses can include up to 100 results, with each result containing its position, title, URL, domain, and snippet. The server excludes ads, sitelinks, video results, and image blocks when assigning organic positions.

Searches are not cached, so agents can request current results for a specific market and device. A page of 10 results typically returns in 2–3 seconds.

How it works

The server communicates with MCP clients over stdio. It calls Serper.live using the API token in SERPER_LIVE_TOKEN, then returns structured tool results to the client. Node.js 20 or newer is required when running it through npx.

Search inputs use a query between 2 and 120 characters, a two-letter country code, and a device of desktop or mobile. The Google interface language can be supplied separately; otherwise, the default language for the selected country is used. Result depth can be set from 1 to 100, with 10 as the default.

Search and ranking calls are charged by pages of up to 10 results according to the selected market. Each request includes an idempotency key, preventing a retried call from being billed twice. list_countries is free and does not require a token.

Setup and configuration

Create a Serper.live account, add credit, and generate an API token. Add the package to an MCP client with npx -y @serper-live/mcp and pass the token through the SERPER_LIVE_TOKEN environment variable.

Claude Code can add the server with its claude mcp add command. Claude Desktop, Cursor, VS Code, and OpenAI Codex can use their respective MCP configuration formats. Claude Desktop also supports installing the downloadable .mcpb bundle, which includes its own Node.js runtime. Other stdio-compatible MCP clients can launch the same npx command directly.

The optional SERPER_LIVE_API_URL variable changes the API base URL; it defaults to https://api.serper.live.

Tools and capabilities

  • google_search retrieves live organic results for a keyword, with positions, titles, URLs, domains, and snippets.
  • domain_position checks every organic position found for a domain, or reports that it is outside the requested top range. Country, device, and search depth can be specified.
  • list_countries returns currently available markets and each market's default Google language.
  • Country, language, device, and result-depth parameters support localized search comparisons and rank checks.

Limitations and notes

Search access depends on available Serper.live credit and market pricing. Desktop and mobile searches cost the same. The token is needed for google_search and domain_position, while market discovery remains available without one. Results represent organic positions only and should not be interpreted as rankings for paid or special Google result blocks.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about @serper Live MCP

@serper-live/mcp is an MCP server that connects AI agents to Serper.live for fresh Google organic search data. Its main tools are google_search for result pages, domain_position for rankings, and list_countries for available markets and their default Google languages, with country, language, device, and result-depth controls.

Install it by configuring your MCP client to run `npx -y @serper-live/mcp` with `SERPER_LIVE_TOKEN` set. Node.js 20 or newer is required for the npx setup. Claude Desktop can also install the downloadable MCP bundle, which supplies its own Node.js runtime.

`SERPER_LIVE_TOKEN` is required for search and ranking tools. `SERPER_LIVE_API_URL` is optional and changes the API base URL from its default of `https://api.serper.live`. The `list_countries` tool works without a token.

@serper-live/mcp has setup instructions for Claude Code, Claude Desktop, Cursor, VS Code, OpenAI Codex, and Cline. Any MCP client that can launch a standard stdio server can run the package with its token in the environment.

It counts organic Google results only, excluding ads, sitelinks, video, and image blocks. `domain_position` returns every matching position when a domain appears more than once, or indicates that it is outside the requested top range.

Related MCP servers

All in Search & Data Extraction All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG Preview@serper Live MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/serper-live-mcp?style=directory)](https://allmcps.com/mcp/serper-live-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/serper-live-mcp"><img src="https://allmcps.com/api/badge/serper-live-mcp?style=directory" alt="@serper Live MCP on AllMCPs" /></a>