Tinysearch
Tinysearch is an MCP server that adds tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Self-hosted web research for MCP agents. It has 236 GitHub stars, is released under the MIT license and runs locally with uvx tinysuite-search.
github.com/TinySuiteHQ/TinySearch (opens in a new tab)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
Install Tinysearch
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"tinysearch": {
"command": "uvx",
"args": [
"tinysuite-search"
],
"env": {
"MCP_TRANSPORT": "your-value",
"TINYSEARCH_CONFIG_PATH": "your-value",
"SEARXNG_URL": "your-value",
"TINYSEARCH_EMBEDDING_BACKEND": "your-value",
"TINYSEARCH_EMBEDDING_MODEL": "your-value"
}
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --env MCP_TRANSPORT=your-value --env TINYSEARCH_CONFIG_PATH=your-value --env SEARXNG_URL=your-value --env TINYSEARCH_EMBEDDING_BACKEND=your-value --env TINYSEARCH_EMBEDDING_MODEL=your-value --transport stdio tinysearch -- uvx tinysuite-searchCursor
{
"mcpServers": {
"tinysearch": {
"type": "stdio",
"command": "uvx",
"args": [
"tinysuite-search"
],
"env": {
"MCP_TRANSPORT": "your-value",
"TINYSEARCH_CONFIG_PATH": "your-value",
"SEARXNG_URL": "your-value",
"TINYSEARCH_EMBEDDING_BACKEND": "your-value",
"TINYSEARCH_EMBEDDING_MODEL": "your-value"
}
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"servers": {
"tinysearch": {
"type": "stdio",
"command": "uvx",
"args": [
"tinysuite-search"
],
"env": {
"MCP_TRANSPORT": "your-value",
"TINYSEARCH_CONFIG_PATH": "your-value",
"SEARXNG_URL": "your-value",
"TINYSEARCH_EMBEDDING_BACKEND": "your-value",
"TINYSEARCH_EMBEDDING_MODEL": "your-value"
}
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Environment variables
Variables the server reads at startup.
| Name | Required | Description |
|---|---|---|
MCP_TRANSPORT | No | MCP transport to serve: stdio (default), sse, or streamable-http. |
TINYSEARCH_CONFIG_PATH | No | Path to a tinysearch_config.json inside the container, for overriding search/embedding defaults. |
SEARXNG_URL | No | SearXNG search endpoint URL. Only needed if not using the bundled Compose SearXNG service. |
TINYSEARCH_EMBEDDING_BACKEND | No | Embedding implementation: onnx (default) or openai_compatible. |
TINYSEARCH_EMBEDDING_MODEL | No | Local ONNX preset (fast, balanced, quality) or a Hugging Face ONNX repository id. |
About Tinysearch
Part of TinySuite. Comes built in to TinyWebUI, and works with any MCP client. TinySearch is the web-research layer of TinySuite, a set of small, local-first tools that make agents spend tokens on useful work rather than overhead. It searches the web, reads the best pages, removes low-value content, and returns compact evidence with source URLs, so your model receives the useful passages instead of paying to process entire webpages.
Similar MCP servers
More other MCP servers
MCP Arr
aplaceforallmystuff/mcp-arr
MCP server for *arr media suite - Sonarr, Radarr, Lidarr, Readarr, Prowlarr.
Active · last commit Nov 15, 2026
OtherTypeScriptUI Beats
nikhils4/ui-beats
Animated React components you own. 55 components built with TypeScript, Tailwind CSS and Motion.
Maintained · last commit Aug 16, 2026
OtherTypeScriptSpanish Top Tech Companies
pugarte7/spanish-top-tech-companies
Tech salaries in Spain by role, region and company, and open job postings to apply to.
Too new to judge · created Aug 25, 2026
OtherJavaScriptInteractive Brokers MCP
code-rabi/interactive-brokers-mcp
Interactive Brokers MCP Server.
Maintained · last commit Jul 21, 2026
OtherJavaScriptGoogle Tag Manager MCP Server
stape-io/google-tag-manager-mcp-server
MCP server for Google Tag Manager.
Active · last commit Nov 3, 2026
OfficialOtherTypeScriptIllustrator MCP Server
ie3jp/illustrator-mcp-server
Adobe Illustrator MCP with 68 tools — more than the official Illustrator MCP.
Active · last commit Nov 11, 2026
OtherTypeScript
How do I install the Tinysearch MCP server?
Add the command uvx tinysuite-search to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is Tinysearch free?
The server is open source under the MIT license, so running it is free. It does not declare any required API key.
Is Tinysearch actively maintained?
The most recent commit was on Nov 15, 2026. The latest release is v0.7.0, published Nov 15, 2026. appsgit only lists MCP servers with a commit in the last six months.