# 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.

- **Type:** MCP server
- **Install:** `agentstack add mcp-spences10-mcp-omnisearch`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [spences10](https://agentstack.voostack.com/s/spences10)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [spences10](https://github.com/spences10)
- **Source:** https://github.com/spences10/mcp-omnisearch

## Install

```sh
agentstack add mcp-spences10-mcp-omnisearch
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# mcp-omnisearch

[](https://viteplus.dev)
[](https://vitest.dev)

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

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

Configure the server in your MCP client with whichever provider keys
you have. Providers without keys are skipped and the rest keep
working.

```json
{
	"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.

```json
{
	"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.

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

### `github_search`

Search GitHub code, repositories, or users.

```json
{
	"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.

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

## Documentation

- [Provider selection](docs/provider-selection.md) — choose providers
  by task, key, mode, and capability.
- [Search operators](docs/search-operators.md) — operator support
  matrix and tested examples.
- [Large results](docs/large-results.md) — inline vs file response
  behavior and remote deployment caveats.
- [Deployment](docs/deployment.md) — MCP client, WSL, Docker, cloud,
  and Firecrawl setup.
- [Troubleshooting](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](CONTRIBUTING.md) before opening a PR.

## License

MIT License - see [LICENSE](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).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [spences10](https://github.com/spences10)
- **Source:** [spences10/mcp-omnisearch](https://github.com/spences10/mcp-omnisearch)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-spences10-mcp-omnisearch
- Seller: https://agentstack.voostack.com/s/spences10
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
