Skip to content
MCP server

OpenSERP

Live results from six search engines with original ranks, plus page extraction

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.1.12
Listing updated
3 days ago

About OpenSERP

OpenSERP is a freemium MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.

Results keep the engine they came from and their original rank, so an agent can compare engines or pick one on purpose, such as Yandex for Russian or Baidu for Chinese. Four search modes cover different needs: a named engine, a preferred engine with ordered fallbacks, the healthiest fast engine, or a merged multi-engine search. Image search and page extraction to Markdown are included.

It runs over stdio from npm. Without an API key it talks to a self-hosted OpenSERP server at localhost:7000; with OPENSERP_API_KEY it uses OpenSERP Cloud, billed in credits that never expire, with 60 free credits to start. Failed and empty requests cost nothing.

Extraction trims long pages to 20,000 characters, or 40,000 across a batch of up to 20 URLs, and marks truncated output so the agent can ask for more.

Install

Run in a terminal

claude mcp add mcp --env OPENSERP_API_KEY='<OPENSERP_API_KEY>' -- npx -y @openserp/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@openserp/mcp"
      ],
      "env": {
        "OPENSERP_API_KEY": "<OPENSERP_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@openserp/mcp"
      ],
      "env": {
        "OPENSERP_API_KEY": "<OPENSERP_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@openserp/mcp"
      ],
      "env": {
        "OPENSERP_API_KEY": "<OPENSERP_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@openserp/mcp"
      ],
      "env": {
        "OPENSERP_API_KEY": "<OPENSERP_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@openserp/mcp"
      ],
      "env": {
        "OPENSERP_API_KEY": "<OPENSERP_API_KEY>"
      }
    }
  }
}

Configuration

  • OPENSERP_API_KEYOpenSERP Cloud API key. Leave unset to use a self-hosted OpenSERP server (http://localhost:7000 by default).
  • OPENSERP_BASE_URLOpenSERP API base URL, for a self-hosted server on another host or port.

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

search
Search one chosen engine, with paging.
any_search
Preferred engine with fallbacks in your order.
fast_search
Picks the healthiest, fastest engine.
mega_search
Compares or merges several engines.
image_search
Images from one engine.
mega_image
Images merged from several engines.
extract
Reads one page as Markdown.
batch_extract
Reads up to 20 pages in one call.
list_engines
Shows engine capabilities and health.
get_usage
Cloud credit balance or last call cost.

What it does

Six engines
Google, Bing, Yandex, Baidu, DuckDuckGo and Ecosia through one tool set.
Fallback modes
any_search and fast_search choose a working engine for you.
Batch extraction
Read up to 20 URLs at once; a dead link doesn't fail the batch.
Regional reads
Pass a region such as DE to read a geo-fenced page.
Self-host or cloud
Use your own OpenSERP server or the paid cloud API.

Good for

  • Ground an answer in live search results
  • Compare Google and Bing rankings for a keyword
  • Extract clean Markdown from a URL before prompting a model
  • Search Chinese or Russian web with the matching engine

Pricing

Freemium

Self-hosted engine free (MIT); cloud pay-as-you-go from about 0.0078 USD per credit, 60 free credits

Prices change. Check openserp.org before you buy.

OpenSERP FAQ

Do I need an API key?

No, if you run a self-hosted OpenSERP server. The cloud API needs OPENSERP_API_KEY.

What does the cloud cost?

Credits start around 0.0078 USD each, one credit per web search page of up to 10 results; 60 credits are free.

Are failed requests charged?

No. Errors, timeouts and empty result pages are free.

Is the engine open source?

Yes. The OpenSERP engine is MIT licensed and runs from Docker or a Go binary.

Is OpenSERP free?

OpenSERP has a free plan, with paid plans for more usage or features.

How do I add OpenSERP to Claude Code?

Run this command in your terminal: claude mcp add mcp --env OPENSERP_API_KEY='<OPENSERP_API_KEY>' -- npx -y @openserp/mcp

What are the best alternatives to OpenSERP?

The closest alternatives to OpenSERP are Scrapling MCP Server, Firecrawl MCP Server, Google Ads + Meta Ads + SEO/GEO MCP, SearXNG Search and Calven.

Alternatives to OpenSERP

  1. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  4. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping