io.github.spences10/mcp-omnisearch MCP Server

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.

<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:

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.