search-boost-mcp

Multi-engine web search MCP server for coding agents. One CLI install wires it into Cursor, Cursor CLI, Codex, Claude Code, Grok Build, and Antigravity.

search-boost family

Project	For	Link
search-boost-mcp (this repo)	Cursor · Codex · Claude · Grok · Antigravity via MCP	you are here
dsh-search-boost	DeepSeek Harness bundle plugin	GitHub · npm
pi-search-boost	pi extension	GitHub · npm

Search engines come from dsh-search-boost (bundled as an npm dependency): on the free layer, Bing, Exa-free, Google News, and Yahoo run in parallel; the api layer adds DuckDuckGo, Antigravity CLI (when available), and keyed Tavily / Brave / Exa. Also included: X/Twitter fallback, Jina page fetch, and deep-research rounds.

中文文档 → README_zh.md

What's new in v0.1.2

• Free-layer engine pool rebuilt after live benchmarks: Bing + Exa-free + Google News + Yahoo for general search; DuckDuckGo kept for domain-restricted routes (e.g. x_search fallback with site: queries).
• x_search fallback auto-prepends site:x.com for multi-engine domain search so keyword mode works without XAI credentials.
• Depends on dsh-search-boost@0.1.2.

---

Install (recommended)

Requires Node ≥ 22.13.

npm install -g search-boost-mcp
search-boost setup          # interactive: keys → layer → agents
# or non-interactive:
search-boost install -y     # all detected agents

Restart each agent after install so MCP reloads.

One-liners by agent

search-boost install -t cursor -y
search-boost install -t codex,claude -y --auto-allow
search-boost install -t grok -y --auto-allow
search-boost install -t antigravity --workspace --auto-allow -y

Preview without writing: search-boost install --dry-run -y

---

What you get

MCP tool	Purpose
fused_search	Multi-engine parallel search, dedupe, cross-ranking
fetch_page	Full page text (Jina + HTML fallback, optional focus)
x_search	X/Twitter keyword / user / thread
deep_research	One research round — gaps + suggested follow-ups
search_layer	Show or set free (keyless) vs api (keyed engines)
search_stats	Cache hits, engine availability, diagnostics

Also: resource search-boost://policy · prompt search_routing

Layers

• free — Bing + Exa-free + Google News + Yahoo; no API keys. DuckDuckGo is used only for domain-restricted searches (e.g. x_search fallback).
• api — free-layer engines plus DuckDuckGo, Antigravity CLI (when available), and Tavily / Brave / Exa when keys are set

Keys: search-boost config keys → ~/.dsh-search-boost-keys.json (or env TAVILY_API_KEY, BRAVE_API_KEY, EXA_API_KEY).

---

CLI cheat sheet

Command	What it does
search-boost	Interactive TUI
search-boost setup	Onboarding (keys + layer + install)
search-boost install / uninstall	Wire MCP + prompts into agents
search-boost serve	Run MCP stdio server (used by agents)
search-boost status	Keys, layer, per-agent configured state
search-boost config keys|layer|search	Keys, default layer, native-search replace
search-boost print <agent>	Print MCP snippet without writing
search-boost agents	Machine-readable agent list

Install flags: -t cursor,codex,…|auto|all · -y (non-interactive) · --dry-run · --auto-allow · --replace-native / --keep-native · --scope user|project (Grok) · --workspace (Antigravity .agents/)

---

Supported agents

Agent	MCP config	Also installs
Cursor IDE / CLI	~/.cursor/mcp.json	hook, skill, optional CLI auto-allow
Codex CLI	~/.codex/config.toml	AGENTS.md, skill
Claude Code	~/.claude.json	CLAUDE.md, skill, permissions
Grok Build	~/.grok/config.toml	rule, skill · grok-plugin
Antigravity	~/.gemini/config/mcp_config.json	AGENTS.md, GEMINI.md, skill, optional workspace

Prompts use model-discretion wording (search when you choose — not forced every turn). See agents/ for per-agent templates.

Native web search: Codex web_search and Claude WebSearch can be disabled with --replace-native (default on -y). Cursor / Antigravity rely on skill + hook preference only. Grok native browse is left on.

---

Grok plugin

grok plugin install ./grok-plugin --trust
search-boost install -t grok -y --auto-allow

Details → grok-plugin/README.md

---

Development

git clone https://github.com/Mr-remon219/search-boost-mcp.git
cd search-boost-mcp && npm install
npm run check && npm run test:install && npm run smoke
node cli.mjs install --dry-run -y

Local clone installs write node /path/to/cli.mjs serve (not npx). Sibling checkout: set SEARCH_BOOST_DSH_ROOT=../dsh-search-boost if needed.

---

License

MIT

---

Links: Issues · dsh-search-boost · pi-search-boost

Friendly link: LINUX DO 社区