What You'll Set Up

By the end of this guide, your AI agent will be able to search the web on your behalf using Google search results via Serper. It can run keyword queries, research competitors, monitor search results for your brand, and gather information from across the internet — all through a simple conversation.

This integration is especially useful for marketing teams, SEO professionals, and anyone who needs to systematically gather information from search results. Instead of manually searching and compiling data, your agent does it for you.

Serper

8 tools · Give your agents access to the entire web

Before You Begin

Make sure you have:

A Serper.dev account — Sign up at serper.dev
A Pipeworks workspace — Sign up at pipeworks.ai if you haven't already

Info

Serper offers 2,500 free searches to get started. Paid plans start at $50/month for 50,000 searches.

Steps

Get your Serper API key

If you don't see an API key, click API Key in the left sidebar to generate one.

Open your Pipeworks console

Log into your Pipeworks workspace and go to the Integrations page. Find Serper in the list and click on it.

Enter your API key

Paste your Serper API key into the Serper API Key field and click Connect.

Pipeworks encrypts your credentials with AES-256-GCM before storing them. The plaintext is never saved to disk and is only decrypted when your integration container starts.

Start the integration

Click Start to launch the Serper integration container. This takes a few seconds. Once the status shows Running, your agent is ready to search.

Test the connection

Use the Test button in your Pipeworks console to verify the connection. This sends a simple search query to confirm your API key is working.

What Your Agent Can Do

Once connected, your AI agent has access to web search tools for:

Web search — Run any Google search query and get structured results with titles, links, and snippets
Site search — Search within a specific website or domain
SERP analysis — Analyze the competitive landscape for any keyword
Rank tracking — Check where your site ranks for target keywords
Brand mention tracking — Search for your brand name to find mentions across the web
Competitor discovery — Find competing websites for any domain
Webpage reading — Extract and analyze content from any webpage
Ranking comparison — Compare keyword rankings between two domains

Connecting from Your AI Agent

Add the Pipeworks tools endpoint to your agent's configuration. Here's an example for Claude Desktop:

json

{'{'}
  "mcpServers": {'{'}
    "pipeworks-serper": {'{'}
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.pipeworks.ai/tools/serper"]
    {'}'}
  {'}'}
{'}'}

Claude Desktop will prompt you to sign in through Pipeworks when you first connect. No access key needed.

Troubleshooting

Connection test fails? Double-check that you copied the full API key from your Serper dashboard.

Getting "Invalid API key" errors? Verify your API key is active in the Serper dashboard and that you haven't exceeded your plan's search limit.

Agent can't find tools? Verify your Pipeworks session is authenticated and that the integration status shows "Running" in your Pipeworks console.

Connect Serper to Pipeworks

Prerequisites