Skip to main content
Glama
searchpipe-mcp

searchpipe-mcp

Official

SearchPipe Integrations

MCP SearchPipe

Official integration packages for SearchPipe — a web search API and MCP server for developers building AI agents.

This repository contains:

  • Remote MCP endpoint — connect any MCP client to SearchPipe via Streamable HTTP (no local install needed)

  • LangChain SDK — pip install langchain-searchpipe for retriever, tool, and answer components

  • Python SDK — pip install searchpipe, official thin client over the Search API

  • TypeScript SDK — npm install searchpipe, official zero-dependency client (ESM + CJS)

The SearchPipe server itself is a managed service at searchpipe.tech. Self-hosting is available on request.

MCP Access (Remote)

Add to your MCP client config (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "searchpipe": {
      "url": "https://searchpipe.tech/mcp/?api_key=sp-your-api-key-here"
    }
  }
}

Or use an Authorization header instead of URL parameter:

{
  "mcpServers": {
    "searchpipe": {
      "url": "https://searchpipe.tech/mcp/",
      "headers": {
        "Authorization": "Bearer sp-your-api-key-here"
      }
    }
  }
}

See claude_desktop_config.json.example for a ready-to-copy template.

Related MCP server: WebQuest MCP

MCP Access (Local stdio)

Run the same tools locally over stdio — mcp-server/ is a thin proxy over the REST API (tool listing works without a key; tool calls use SEARCHPIPE_API_KEY):

pip install "searchpipe-mcp @ git+https://github.com/SearchPipe/searchpipe-mcp.git#subdirectory=mcp-server"
SEARCHPIPE_API_KEY=sp-your-key searchpipe-mcp

Or with Docker (from the repository root):

docker build -t searchpipe-mcp .
docker run -i --rm -e SEARCHPIPE_API_KEY=sp-your-key searchpipe-mcp

LangChain Integration

pip install langchain-searchpipe

See langchain-searchpipe/README.md for full usage examples (retriever, tool, answer components).

Official SDKs

Both SDKs are thin wrappers over POST /search — same parameters, same response shape as the REST API.

Python (sdks/python/):

pip install searchpipe
from searchpipe import SearchPipe

client = SearchPipe(api_key="sp-YOUR_KEY")
resp = client.search("FastAPI tutorial", max_results=5, include_answer=True)
print(resp.answer)
for r in resp.results:
    print(r.score, r.title, r.url)

JavaScript / TypeScript (sdks/typescript/):

npm install searchpipe
import { SearchPipe } from "searchpipe";

const client = new SearchPipe({ apiKey: "sp-YOUR_KEY" });
const resp = await client.search({ query: "FastAPI tutorial", maxResults: 5, includeAnswer: true });
console.log(resp.answer);

Both default to https://searchpipe.tech and read the key from SEARCHPIPE_API_KEY. See each SDK's README for the full API, error classes, and self-hosting options.

Getting an API Key

  1. Sign up at searchpipe.tech

  2. Verify your email

  3. Go to Dashboard → API Keys → copy your sp- key

  4. New accounts receive free credits to try the service

Tool Schema

Run a web search with optional AI-generated answer.

Parameter

Type

Required

Default

Description

query

string

✅

—

Search query

max_results

integer

—

5

Number of results (1–20)

include_answer

boolean

—

false

Include AI-generated answer

include_raw_content

boolean

—

false

Include full page content

api_key

string

—

—

API key (or use env var / URL param)

Returns: Tavily-style SearchResponse with query, answer, results[].

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      MCP server enabling local-first web search, fetch, extract, and caching with citeable excerpts, no API key required. Supports research workflows for agents and apps.
      96 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Gives MCP-capable agents live web access: search the web, scrape pages into Markdown (including JavaScript-heavy and bot-protected sites), and extract named fields as JSON, with job polling, token-aware content offloading, and built-in research guidance. Ships as a self-hostable stdio or HTTP service with spend caps and per-request key support.
      7
      MIT