# @serper-live/mcp [Health: Active]

**Category:** 🔎 Search & Data Extraction  
**Repository:** https://github.com/serper-live/serper-live-mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 1027  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/serper-live-mcp

## Description
MCP server for Serper.live: live Google search results, domain positions and open markets for AI agents

## Tools
Capabilities this server exposes over MCP:

- **google_search** — 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. 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 (https://serper.live/pricing). Use it to see the whole result list; to check where one site ranks, use domain_position instead.
- **domain_position** — 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 started 10 results of depth (https://serper.live/pricing).
- **list_countries** — 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.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp": {
    "command": "npx",
    "args": ["-y","@serper-live/mcp"],
    "env": {
      "SERPER_LIVE_TOKEN": "",
      "SERPER_LIVE_API_URL": ""
    }
  }
}
```

**Requires environment variables:** `SERPER_LIVE_TOKEN`, `SERPER_LIVE_API_URL` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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.

_Full upstream README: https://allmcps.com/mcp/serper-live-mcp/readme_