# SearchPipe

Web search for AI agents: ranked hits with source URLs and an optional AI-written answer. Runs as a remote endpoint, so nothing goes on your machine.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: SearchPipe
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SearchPipe/searchpipe-mcp
- Updated: 2026-09-30
- HTML: https://affpapa.org/en/nevibecode/mcp/searchpipe

## What it does

SearchPipe is a hosted search service that talks to an MCP client over Streamable HTTP. Your agent gets one tool, `searchpipe_search`, and calls it with a question. Back come numbered results with URLs and relevance scores. Turn on `include_answer` and you also get a model-written summary; turn on `include_raw_content` and each hit carries the full page text. Five results arrive unless you ask for more, up to 20.

There is no binary to install. You point the client at an endpoint and supply an `sp-…` key, either in the URL as `api_key` or in an `Authorization: Bearer …` header. The header keeps the key out of logged URLs. Keys come from the dashboard after signup and email verification, and new accounts start with free credits.

The repository also ships thin clients for Python and TypeScript that wrap `POST /search`, plus `langchain-searchpipe` with a retriever and a tool. Those packages take the key from `SEARCHPIPE_API_KEY` and mirror the REST parameters. Miss the key and the tool cannot authenticate, so sort out credentials before wiring it in.

## Requirements
- Remote server: `https://searchpipe.tech/mcp/`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http searchpipe https://searchpipe.tech/mcp/
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add searchpipe --url https://searchpipe.tech/mcp/
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "searchpipe": {
            "url": "https://searchpipe.tech/mcp/"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "searchpipe": {
            "type": "http",
            "url": "https://searchpipe.tech/mcp/"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http searchpipe https://searchpipe.tech/mcp/
```

## When to use it
- give an agent current web results instead of stale model knowledge
- attach a source link to every search hit
- get a direct answer to a question without a second pass over pages
- pull full page text for follow-up analysis
- drop search into a LangChain pipeline with a ready retriever

## Example prompts
- Search the web with SearchPipe for FastAPI changes over the past year and list the source links
- Run `searchpipe_search` on the Python 3.13 migration and set `include_answer` to true
- Look up this stack trace, return 10 hits with full page content

## Similar
- [deepagents-python-quickstart](https://affpapa.org/en/nevibecode/skills/deepagents-python-quickstart.md) — skill · 5000 installs
- [deepagents-typescript-quickstart](https://affpapa.org/en/nevibecode/skills/deepagents-typescript-quickstart.md) — skill · 4900 installs
- [anysearch](https://affpapa.org/en/nevibecode/skills/anysearch.md) — skill · 38500 installs
- [web-search](https://affpapa.org/en/nevibecode/skills/brave-web-search.md) — skill · 4700 installs
- [firecrawl-alexandria](https://affpapa.org/en/nevibecode/skills/firecrawl-alexandria.md) — skill · 1700 installs
- [exa-search](https://affpapa.org/en/nevibecode/skills/exa-labs-exa-search.md) — skill · 1400 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md