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.

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 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 for secure options and plaintext fallback guidance.

Tools

web_search

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

{
	"query": "latest SvelteKit releases",
	"provider": "tavily",
	"limit": 10,
	"search_depth": "advanced",
	"topic": "news",
	"time_range": "month",
	"safe_search": true,
	"include_raw_content": false,
	"auto_parameters": false
}

Search controls apply when supported by the selected provider.

ai_search

Get sourced AI answers with Kagi FastGPT, Exa Answer, Linkup, or Tavily Research. Tavily Research returns a task ID first; pass it back as research_id to retrieve the report.

{
	"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": "tavily",
	"mode": "extract",
	"extract_depth": "advanced",
	"query": "installation requirements",
	"chunks_per_source": 3,
	"format": "markdown"
}

Documentation

by task, key, mode, and capability.

• Provider selection — choose providers

matrix and tested examples.

• Search operators — operator support

behavior and remote deployment caveats.

• Large results — inline vs file response

setup.

• Deployment — MCP client, WSL, and Firecrawl

validation, rate limits, and common failures.

• Troubleshooting — keys, access,

Environment variables

• TAVILYAPIKEY
• KAGIAPIKEY
• BRAVEAPIKEY
• GITHUBAPIKEY
• EXAAPIKEY
• LINKUPAPIKEY
• FIRECRAWLAPIKEY
• FIRECRAWLBASEURL optional, for self-hosted Firecrawl
• OMNISEARCHLARGERESULT_MODE optional, file default or inline

Development

pnpm install
pnpm run build
pnpm test

Shortened. The full README is on GitHub.