OpenSERP — Claude Code MCP server: search and install
OpenSERP adds live search across six engines, image search, and Markdown page extraction to AI coding clients. Useful when an agent needs sourced web results.
MIT ★ 3 updated 2026-10-27
claude mcp add --env OPENSERP_API_KEY=<OPENSERP_API_KEY> --env OPENSERP_BASE_URL=<OPENSERP_BASE_URL> --transport stdio openserp -- npx -y @openserp/mcpWhat OpenSERP does
OpenSERP gives an AI agent tools for Google, Bing, Yandex, Baidu, DuckDuckGo, and Ecosia. Search responses retain the engine and original rank. The server also supports image queries, single-page extraction, and batch extraction, with separate tools for a preferred engine, fallbacks, and multi-engine comparison.
Run it with npx -y @openserp/mcp or install the package globally with npm. When OPENSERP_API_KEY is absent, it uses OSS mode at http://localhost:7000; Cloud access needs the API key. batch_extract accepts up to 20 URLs, while extracted pages are cut to context limits and can request more text through maxChars.
The server can be connected to Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, or Gemini CLI. Search will not work until a local OpenSERP service or a Cloud API key is available.
What it helps with
- search across a specific engine
- compare Google and Bing rankings
- turn a web page into Markdown
- extract several URLs in one request
- check Cloud credit usage
Example prompts for the agent
- Search Yandex for the current documentation for this library and return the first 5 URLs.
- Compare Google and Bing for this SEO query, keeping each result’s original rank.
- Extract these URLs as Markdown with
batch_extractand use the pages to answer me.
How to install OpenSERP
Platform CLI
claude mcp add --env OPENSERP_API_KEY=<OPENSERP_API_KEY> --env OPENSERP_BASE_URL=<OPENSERP_BASE_URL> --transport stdio openserp -- npx -y @openserp/mcpReplace <…> with your own values
Platform CLI
codex mcp add openserp --env OPENSERP_API_KEY=<OPENSERP_API_KEY> --env OPENSERP_BASE_URL=<OPENSERP_BASE_URL> -- npx -y @openserp/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"openserp": {
"command": "npx",
"args": [
"-y",
"@openserp/mcp"
],
"env": {
"OPENSERP_API_KEY": "<OPENSERP_API_KEY>",
"OPENSERP_BASE_URL": "<OPENSERP_BASE_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"openserp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@openserp/mcp"
],
"env": {
"OPENSERP_API_KEY": "<OPENSERP_API_KEY>",
"OPENSERP_BASE_URL": "<OPENSERP_BASE_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e OPENSERP_API_KEY=<OPENSERP_API_KEY> -e OPENSERP_BASE_URL=<OPENSERP_BASE_URL> openserp npx -y @openserp/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about OpenSERP
How do I install OpenSERP in Claude Code?
Run claude mcp add mcp -e OPENSERP_API_KEY=<OPENSERP_API_KEY> -- npx -y @openserp/mcp.
What does OpenSERP do?
It gives MCP clients web search across Google, Bing, Yandex, Baidu, DuckDuckGo, and Ecosia, plus image search and Markdown extraction. Search results retain their source engine and rank.
Can OpenSERP run without an API key?
Yes. Without OPENSERP_API_KEY, it uses OSS mode at http://localhost:7000; OpenSERP Cloud requires the key.