MCP.so
Sign In

Google Programmable Search Engine (PSE) MCP Server

@rendyfebry

Repository

About Google Programmable Search Engine (PSE) MCP Server

A Model Context Protocol (MCP) server for the Google Programmable Search Engine (PSE) API

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "google-pse-mcp": {
      "disabled": false,
      "timeout": 60,
      "command": "npx",
      "args": [
        "-y",
        "google-pse-mcp",
        "https://www.googleapis.com/customsearch",
        "<api_key>",
        "<cx>",
        "<siteRestricted>"
      ],
      "transportType": "stdio"
    }
  }
}

Tools

1

`q` (string, required): Search query

Overview

What is Google Programmable Search Engine (PSE) MCP Server?

A Model Context Protocol (MCP) server for the Google Programmable Search Engine (PSE) API. It exposes a search tool that lets MCP-compatible clients (such as VS Code, Copilot, and Claude Desktop) perform web searches using Google Custom Search.

How to use Google Programmable Search Engine (PSE) MCP Server?

No manual cloning or installation is needed. Add the configuration snippet to your MCP client’s settings (e.g., VS Code’s settings.json or Cline’s cline_mcp_settings.json), replacing <api_key> and <cx> with your Google API key and custom search engine ID. An optional <siteRestricted> flag (true/false) controls the endpoint used.

Key features of Google Programmable Search Engine (PSE) MCP Server

  • Single search tool with rich parameter support
  • Configurable result size (1–10 per page)
  • Language and safe search filtering
  • Optional site‑restricted API endpoint
  • Works with any stdio‑based MCP client

Use cases of Google Programmable Search Engine (PSE) MCP Server

  • Perform targeted web searches from within an AI‑powered coding assistant
  • Integrate Google Custom Search results into automated research workflows
  • Build custom search experiences limited to specific sites (via siteRestricted)

FAQ from Google Programmable Search Engine (PSE) MCP Server

What credentials do I need?

You need a Google API key and a Custom Search Engine ID (cx). Both are available from the Google Cloud Console.

How does the siteRestricted flag work?

It determines whether the server uses the Site‑Restricted API endpoint or the standard Custom Search endpoint. The default value (true) uses the restricted endpoint; set it to false to use the standard endpoint.

What parameters does the search tool accept?

Required: q (query). Optional: page (number), size (1–10), sort (only "date"), safe (boolean), lr (language code), and siteRestricted (boolean).

What runtime does the server require?

The server runs via npx (Node.js package runner). No separate installation steps are needed.

Which transport does it use?

The server communicates over stdio, which is the default transport for MCP servers.

Frequently asked questions

What credentials do I need?

You need a Google API key and a Custom Search Engine ID (cx). Both are available from the Google Cloud Console.

How does the `siteRestricted` flag work?

It determines whether the server uses the Site‑Restricted API endpoint or the standard Custom Search endpoint. The default value (`true`) uses the restricted endpoint; set it to `false` to use the standard endpoint.

What parameters does the `search` tool accept?

Required: `q` (query). Optional: `page` (number), `size` (1–10), `sort` (only `"date"`), `safe` (boolean), `lr` (language code), and `siteRestricted` (boolean).

What runtime does the server require?

The server runs via `npx` (Node.js package runner). No separate installation steps are needed.

Which transport does it use?

The server communicates over stdio, which is the default transport for MCP servers.

Comments

Basic information

Category

Search

License

Apache-2.0

Transports

stdio

Author

rendyfebry

More Search MCP servers

Google Search MCP Server

mixelpixx

MCP Server built for use with Claude Code, Claude Desktop, VS Code, Cline - enable google search and ability to follow links and research websites

249

Google News MCP Server

ChanMeng666

【Star-crossed coders unite!⭐️】Model Context Protocol (MCP) server implementation providing Google News search capabilities via SerpAPI, with automatic news categorization and multi-language support.

124

Everything Search MCP Server

mamertofabian

344

Google Search Tool

web-agent-master

A Playwright-based Node.js tool that bypasses search engine anti-scraping mechanisms to execute Google searches. Local alternative to SERP APIs with MCP server integration.

611

Search Console Mcp

saurabhsharma2u

Search & analytics data as infrastructure — MCP server for Google Search Console, Bing Webmaster Tools, and GA4, designed for AI agents and automation.

205