mcp-omnisearch
π A Model Context Protocol (MCP) server providing unified access to multiple search engines (Tavily, Brave, Kagi, Exa), AI tools (Kagi FastGPT, Exa, Linkup), and content extraction services (Firecrawl, Tavily, Kagi). Includes GitHub search. All through a single interface.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/spences10/mcp-omnisearch with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/spences10/mcp-omnisearch'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/spences10--mcp-omnisearch)HTML
<a href="/listings/spences10--mcp-omnisearch"><img src="/api/listings/spences10--mcp-omnisearch/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Install the published server with [MCPick](https://github.com/spences10/mcpick):
npx mcpick add \ --name mcp-omnisearch \ --command npx \ --args=-y,mcp-omnisearch
MCPick defaults to Claude Code. Use `--client` and `--scope` to target another client or add the server to the current repository:
npx mcpick add \ --name mcp-omnisearch \ --command npx \ --args=-y,mcp-omnisearch \ --client vscode \ --scope project
See [Deployment](docs/deployment.md#install-with-mcpick) for supported clients and provider credential storage options.
To run from source instead:
pnpm install pnpm run build node ./dist/index.js
Providers without keys are skipped and the rest keep working. If your client supports environment-variable expansion, reference keys instead of storing their values in the MCP configuration:
{
"mcpServers": {
"mcp-omnisearch": {
"command": "npx",
"args": ["-y", "mcp-omnisearch"],
"env": {
"TAVILY_API_KEY": "${TAVILY_API_KEY}",
"EXA_API_KEY": "${EXA_API_KEY}"
}
}
}
}Add only the provider keys you use. Expansion syntax and secret storage are client-specific; see [Deployment](docs/deployment.md#keep-provider-keys-out-of-mcp-configuration) for secure options and plaintext fallback guidance.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md Β· README Β· 170 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # mcp-omnisearch
- [](https://viteplus.dev)
- [](https://vitest.dev)
- A Model Context Protocol (MCP) server for Tavily, Brave, Kagi, Exa,
- GitHub, Linkup, and Firecrawl. Two tools, `search` and `execute`,
- expose schema-generated native provider functions through Pi's local
- QuickJS sandbox. Requires Node.js 22.19+.
- <a href="https://glama.ai/mcp/servers/gz5wgmptd8">
- <img width="380" height="200" src="https://glama.ai/mcp/servers/gz5wgmptd8/badge" alt="Glama badge" />
- </a>
- ## Quick start
- Install the published server with
- [MCPick](https://github.com/spences10/mcpick):
- ```bash
- npx mcpick add \
- --name mcp-omnisearch \
- --command npx \
- --args=-y,mcp-omnisearch
- ```
- MCPick defaults to Claude Code. Use `--client` and `--scope` to target
- another client or add the server to the current repository:
- ```bash
- npx mcpick add \
- --name mcp-omnisearch \
- --command npx \
- --args=-y,mcp-omnisearch \
- --client vscode \
- --scope project
- ```
- See
- [Deployment](https://github.com/spences10/mcp-omnisearch/blob/main/docs/deployment.md#install-with-mcpick)
- for supported clients and provider credential storage options.
- To run from source instead:
- ```bash
- pnpm install
- pnpm run build
- node ./dist/index.js
- ```
- Providers without keys are skipped and the rest keep working. If your
- client supports environment-variable expansion, reference keys instead
- of storing their values in the MCP configuration:
- ```json
- {
- "mcpServers": {
- "mcp-omnisearch": {
- "command": "npx",
- "args": ["-y", "mcp-omnisearch"],
- "env": {
- "TAVILY_API_KEY": "${TAVILY_API_KEY}",
- "EXA_API_KEY": "${EXA_API_KEY}"
- }
- }
- }
- }
- ```
- Add only the provider keys you use. Expansion syntax and secret
- storage are client-specific; see
- [Deployment](https://github.com/spences10/mcp-omnisearch/blob/main/docs/deployment.md#keep-provider-keys-out-of-mcp-configuration)
- for secure options and plaintext fallback guidance.
- ## Tools
- ### `search`
- Discover available functions and their compact TypeScript
- declarations. A provider-scoped lookup returns names and schemas
- together:
- ```json
- { "query": "tavily" }
- ```
- Use an exact name such as `tavily_search` for a smaller lookup, or
- `{}` for a catalog without declarations. Only configured providers
- appear.
- ### `execute`
- Run JavaScript against the discovered native provider functions:
- ```json
- {
- "code": "const r = await tools.tavily_search({ query: 'MCP code mode', max_results: 3 }); return r.results.map(({ title, url }) => ({ title, url }));"
- }
- ```
- Compose calls with `await` and `Promise.all`, filter intermediate
- data, and return only what the client needs. Credentials stay on the
- host; the sandbox has no filesystem or arbitrary network access.
- Arguments and responses use native provider formats, not a normalized
- search contract. See
- [Code Mode](https://github.com/spences10/mcp-omnisearch/blob/main/docs/codemode.md)
- for functions, limits and benchmark findings.
- ## Upgrading
- The consolidated `web_search`, `ai_search`, `web_extract` and
- `github_search` tools have been removed. Provider keys stay the same,
- but existing tool calls and client instructions need migration. See
- the
- [breaking-change migration guide](https://github.com/spences10/mcp-omnisearch/blob/main/docs/migration.md).
- ## Documentation
- - [Migration](https://github.com/spences10/mcp-omnisearch/blob/main/docs/migration.md)
- β move from consolidated tools to Code Mode.
- - [Code Mode](https://github.com/spences10/mcp-omnisearch/blob/main/docs/codemode.md)
- β native provider functions, schema generation, local testing, and
- benchmark findings.
- - [Provider selection](https://github.com/spences10/mcp-omnisearch/blob/main/docs/provider-selection.md)
- β choose providers by task, key, mode, and capability.
- - [Search operators](https://github.com/spences10/mcp-omnisearch/blob/main/docs/search-operators.md)
- β native query syntax and provider-specific filters.
- - [Large results](https://github.com/spences10/mcp-omnisearch/blob/main/docs/large-results.md)
- β inline vs file response behavior and remote deployment caveats.
- - [Deployment](https://github.com/spences10/mcp-omnisearch/blob/main/docs/deployment.md)
- β MCP client, WSL, and Firecrawl setup.
- - [Troubleshooting](https://github.com/spences10/mcp-omnisearch/blob/main/docs/troubleshooting.md)
- β keys, access, validation, rate limits, and common failures.
- ## Environment variables
- - `TAVILY_API_KEY`
- - `KAGI_API_KEY`
- - `BRAVE_API_KEY`
- - `GITHUB_API_KEY`
- - `EXA_API_KEY`
- - `LINKUP_API_KEY`
- - `FIRECRAWL_API_KEY`
- - `FIRECRAWL_BASE_URL` optional, for self-hosted Firecrawl
- - `OMNISEARCH_LARGE_RESULT_MODE` optional, `file` default or `inline`
- ## Development
- ```bash
- pnpm install
- pnpm run build
- pnpm test
- ```
- Please read
- [CONTRIBUTING.md](https://github.com/spences10/mcp-omnisearch/blob/main/CONTRIBUTING.md)
- before opening a PR.
- ## License
- MIT License - see
- [LICENSE](https://github.com/spences10/mcp-omnisearch/blob/main/LICENSE).
- ## Acknowledgments
- Built on
- [Model Context Protocol](https://github.com/modelcontextprotocol),
- [Tavily](https://tavily.com), [Kagi](https://kagi.com),
- [Brave Search](https://search.brave.com), [Exa AI](https://exa.ai),
- [Linkup](https://linkup.so), and [Firecrawl](https://firecrawl.dev).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itβs helped, pass it on.