Tinysearch MCP Server

Spend tokens on answers, not webpages. TinySearch searches, crawls, and reranks the web locally, then gives your agent only the evidence worth putting in its context.

People who work with Otel and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-05 · ★ 227 · #6 OF 51 MAINTAINED SEARCH · VERIFIED 2026-09-18

MIT · Python servers · how we verify → /methodology

01 · Install Tinysearch

before you install - you'll need

Set OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL before connecting.

Claude Code

claude mcp add marcellm01-tinysearch -- uvx tinysuite-search

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "marcellm01-tinysearch": {
      "command": "uvx",
      "args": [
        "tinysuite-search"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · container (OCI image) - can be sandboxed away from your filesystem

license MIT - declared in the repository

pypi package tinysuite-search - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.MarcellM01 is GitHub-verified and matches the repo owner

03 · What Tinysearch can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.6.4 · 2026-09-05

v0.6.4 · Browser automation has landed as a retrieval primitive: TinySearch can now drive a browser to interact with pages (click, fill, navigate) as part of retrieval, not just fetch static HTML. It's held up well in…

v0.6.3 · 2026-09-01

TinySearch 0.6.3 · Restore single-query backward compatibility for search · Feat/optional opentelemetry otlp · Highlights · Added · Optional OpenTelemetry (OTLP) export. TinySearch can now emit vendor-neutral · traces…

v0.6.2 · 2026-08-24

TinySearch v0.6.2 · TinySearch v0.6.2 makes web research more focused and efficient, with smarter handling of overlapping crawl evidence and a set of quality and performance optimizations. · Semantic deduplication for…

04 · Who maintains Tinysearch

tinysearch is maintained by marcellm01. It's the only MCP server we track from this author; the repo dates to May 2026.

05 · Facts

repository: github.com/marcellm01/tinysearch
website: https://github.com/MarcellM01/TinySearch
category: search - ranked #6 of 51 actively-maintained search servers as of 2026-09-18.
release cadence: 10+ releases in the last 90 days (latest 2026-09-05)
registry: io.github.MarcellM01/tinysearch (active, first published 2026-07-16 · 2 versions)
packages: oci:docker.io/marcellm01/tinysearch:v0.4.0 · pypi:tinysuite-search

06 · Tinysearch FAQ

What is Tinysearch?

Spend tokens on answers, not webpages. TinySearch searches, crawls, and reranks the web locally, then gives your agent only the evidence worth putting in its context.

Is Tinysearch still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-05 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

How do I install Tinysearch?

Run `uvx tinysuite-search`. The README documents 3 environment variables (OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL) to set first. Set OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL before connecting. You can also paste the ready-made client config above.

Does Tinysearch run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Tinysearch

Alternatives to Tinysearch

Maintained search servers if Tinysearch isn't the fit.

Pairs well with

Servers that cover what Tinysearch doesn't - only shown when the pairing reason fits the companion.

More search MCP servers · Sylex Search · OpenResearch MCP · Openwebninja MCP · Retrieval

More Python MCP servers · MaBoSS Boolean Network Simulator · NeKo Biological Network Builder · PhysiCell Configuration Builder · Server Spreadsheet · Apolo Cad · see all