# Untapped SERP

> Untapped SERP is an open-source MCP server for web search and scraping. MCP server returning live Google results and keyword volume via your DataForSEO account. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Repository:** https://github.com/ctf-max/untapped-plugins/tree/HEAD/untapped-serp
- **MCP Registry name:** io.github.CTF-Max/untapped-serp
- **Categories:** [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping), [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-18

## About

The README says this server gives an AI agent what Google displays for a phrase in a specific location and on a chosen device, including positions, People Also Ask, the local pack, sites cited in AI Overviews, the featured snippet, and every position a given domain holds. It also returns Google Ads monthly search volume, CPC, competition and a 12-month trend.

Requests go through the user's own DataForSEO account rather than a vendor-hosted service. A daily spend cap, set by default to $1.00 in UTC, stops paid calls once charged plus in-flight spend would exceed it. Responses are cached for 24 hours for SERP queries and 30 days for volume queries, and a sandbox mode returns dummy data for free testing.

It suits SEO and content teams who want search data inside Claude Code or Codex rather than from the agent's built-in index. Setup requires a DataForSEO login and Python 3.10+ on the PATH, with no pip dependencies.

## Features

- **Live Google organic results:** Returns current Google SERP results for a keyword, location and device combination.
- **Keyword search volume:** Provides Google Ads monthly volume, CPC, competition and a 12-month trend for up to 100 keywords per call.
- **Daily spend cap:** Blocks paid calls once charged and in-flight spend for the UTC day would pass the configured limit.
- **Cost estimation and ledger:** Lets callers estimate a call's cost before running it and records the cost each response reports.
- **Response caching:** Reuses recent results within a cache window so repeated requests do not incur new charges.
- **Free sandbox mode:** Switches to DataForSEO's sandbox with dummy data for round-trip testing without cost.

## Good for

- Checking where a domain ranks for a phrase in a specific city or on mobile
- Seeing which sites Google's AI Overview cites for a query
- Pulling monthly search volume for a batch of keywords during content planning
- Tracking People Also Ask questions and featured snippets for a topic
- Keeping API spend on DataForSEO within a fixed daily budget

## Install

### Claude Code (Terminal)

```sh
claude mcp add untapped-serp -- npx -y https://github.com/CTF-Max/untapped-plugins/releases/download/v0.2.0/untapped-serp-mcp-0.2.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "untapped-serp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/CTF-Max/untapped-plugins/releases/download/v0.2.0/untapped-serp-mcp-0.2.0.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "untapped-serp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/CTF-Max/untapped-plugins/releases/download/v0.2.0/untapped-serp-mcp-0.2.0.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "untapped-serp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/CTF-Max/untapped-plugins/releases/download/v0.2.0/untapped-serp-mcp-0.2.0.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "untapped-serp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/CTF-Max/untapped-plugins/releases/download/v0.2.0/untapped-serp-mcp-0.2.0.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "untapped-serp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/CTF-Max/untapped-plugins/releases/download/v0.2.0/untapped-serp-mcp-0.2.0.mcpb"
      ]
    }
  }
}
```

## Tools

- `google_serp`: Live Google organic results for one keyword, location and device.
- `google_search_volume`: Monthly volume, CPC, competition and 12-month trend for 1-100 keywords.
- `serp_estimate`: Cost reserve for a call and whether today's cap allows it.
- `serp_spend`: Spend today and this month, the cap, recent calls, and credential status.

## FAQ

### Whose account is used for the search data?

The README says calls are made through the user's own DataForSEO account, using their API login and password.

### What happens if the daily cap is reached?

Paid calls stop once charged plus in-flight spend for the UTC day would pass the cap, which defaults to $1.00.

### Are results cached?

Yes. The README gives a 24-hour cache window for SERP results and 30 days for search volume, and max_age_hours set to 0 forces a fresh request.

### Are retries automatic if a call times out?

No. A call with an unknown outcome is never retried automatically, and its reserved cost stays counted against the day's cap.

### Is Untapped SERP free?

Yes. Untapped SERP is open source, so you can use and self-host it for free.

### How do I add Untapped SERP to Claude Code?

Run this command in your terminal: claude mcp add untapped-serp -- npx -y https://github.com/CTF-Max/untapped-plugins/releases/download/v0.2.0/untapped-serp-mcp-0.2.0.mcpb

### What are the best alternatives to Untapped SERP?

The closest alternatives to Untapped SERP are SEO Data MCP (SteadyScrape), SerpResult, Kumpay AEO MCP, Seo Data and SEO Tools: Keyword Research, SERP, Backlinks & Rank Tracking.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [SEO Data MCP (SteadyScrape)](https://ai-powered.com/mcp/seo-data-mcp-steadyscrape): SEO Data MCP (SteadyScrape) is a paid MCP server for marketing and seo.
- [SerpResult](https://ai-powered.com/mcp/serpresult): SerpResult is a freemium MCP server for web search and scraping.
- [Kumpay AEO MCP](https://ai-powered.com/mcp/kumpay-aeo-mcp): Kumpay AEO MCP is a freemium MCP server for marketing and seo.
- [Seo Data](https://ai-powered.com/mcp/seo-data): Seo Data is an MCP server for marketing and seo.
- [SEO Tools: Keyword Research, SERP, Backlinks & Rank Tracking](https://ai-powered.com/mcp/seo-tools-keyword-research-serp-backlinks-and-rank-tracking): SEO Tools: Keyword Research, SERP, Backlinks & Rank Tracking is a paid MCP server for marketing and seo.
- [DataFluxor](https://ai-powered.com/mcp/datafluxor): DataFluxor is a freemium MCP server for marketing and seo.
- [SEO and Keyword Data API](https://ai-powered.com/mcp/seo-and-keyword-data-api): SEO and Keyword Data API is a paid MCP server for marketing and seo.
- [SEOclar — SEO MCP Server](https://ai-powered.com/mcp/seoclar-seo-mcp-server): SEOclar — SEO MCP Server is a paid MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/untapped-serp
