MCP Omnisearch

Unified access to multiple search providers and AI tools like Tavily, Perplexity, Kagi, Jina AI, Brave, and Firecrawl.

Documentation

mcp-omnisearch

A Model Context Protocol (MCP) server that provides unified access to Tavily, Brave, Kagi, Exa AI, GitHub, Linkup, and Firecrawl through four consolidated tools.

Quick start

Install the published server with 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 for secret-safe provider-key setup and the supported clients.

To run from source instead:

pnpm install
pnpm run build
node ./dist/index.js

You can also configure the server manually with whichever provider keys you have. Providers without keys are skipped and the rest keep working.

{
	"mcpServers": {
		"mcp-omnisearch": {
			"command": "node",
			"args": ["/path/to/mcp-omnisearch/dist/index.js"],
			"env": {
				"TAVILY_API_KEY": "your-tavily-key",
				"KAGI_API_KEY": "your-kagi-key",
				"BRAVE_API_KEY": "your-brave-key",
				"GITHUB_API_KEY": "your-github-token",
				"EXA_API_KEY": "your-exa-key",
				"LINKUP_API_KEY": "your-linkup-key",
				"FIRECRAWL_API_KEY": "your-firecrawl-key"
			}
		}
	}
}

Tools

`web_search`

Search the web with Tavily, Brave, Kagi, Exa, or Kagi Enrichment.

{
	"query": "sveltekit remote functions site:docs.svelte.dev",
	"provider": "brave",
	"limit": 10
}

`ai_search`

Get sourced AI answers with Kagi FastGPT, Exa Answer, or Linkup.

{
	"query": "Explain the differences between REST and GraphQL",
	"provider": "kagi_fastgpt"
}

`github_search`

Search GitHub code, repositories, or users.

{
	"query": "filename:remote.ts @sveltejs/kit",
	"search_type": "code",
	"limit": 5
}

`web_extract`

Extract, crawl, scrape, summarize, or find similar content with Tavily, Kagi, Firecrawl, or Exa.

{
	"url": "https://example.com/long-article",
	"provider": "kagi",
	"mode": "summarize"
}

Documentation

Provider selection — choose providers by task, key, mode, and capability.
Search operators — operator support matrix and tested examples.
Large results — inline vs file response behavior and remote deployment caveats.
Deployment — MCP client, WSL, and Firecrawl setup.
Troubleshooting — 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

pnpm install
pnpm run build
pnpm test

Please read CONTRIBUTING.md before opening a PR.

License

MIT License - see LICENSE.

Acknowledgments

Built on Model Context Protocol, Tavily, Kagi, Brave Search, Exa AI, Linkup, and Firecrawl.