Agent Search MCP

A Node.js MCP server and CLI for English and Chinese web search. Agent Search MCP starts without an API key. It returns compact multi-source evidence, records provider failures, and bounds work with request and evidence budgets. Paid providers run only when policy and credentials allow. Its 7 documented tools cover free, article. It runs locally over stdio via the published package.

People connecting search tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-17 · ★ 107 · #6 OF 47 MAINTAINED SEARCH · VERIFIED 2026-08-25

Apache-2.0 · TypeScript servers · how we verify → /methodology

01 · Install Agent Search MCP

before you install - you'll need

HTTP_AUTH_TOKEN

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add lennney-agent-search-mcp -- npx -y agent-search-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "lennney-agent-search-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "agent-search-mcp"
      ]
    }
  }
}

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

license Apache-2.0 - declared in the repository

npm package agent-search-mcp - unscoped; check the name against the project README before installing

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

03 · What Agent Search MCP can do

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

What you can build

With this server connected, an agent can extract a URL as clean Markdown, fetch a public GitHub repository README, fetch a CSDN article, and fetch a Juejin article.

Capability map

Tools grouped from the project's README - what Agent Search MCP lets an agent do.

read & search

4 tools - e.g. Fetch a public GitHub repository README; Fetch a CSDN article; Fetch a Juejin article

fetch_github_readme · fetch_csdn_article · fetch_juejin_article · search_with_synthesis

Free

3 tools - e.g. Multi-engine Web Search with bounded fallback; Filtered waterfall search and optional enrichment; Extract a URL as clean Markdown

free_search · free_search_advanced · free_extract

Latest releases

v3.2.1 · 2026-08-11

This release makes Agent Search MCP easier for agents to select and cheaper to use by aligning public metadata and tool-routing instructions around free-first Chinese and English web search with compact inspectable…

v3.2.0 · 2026-07-28

Agent Search MCP v3.2.0 · Free search remains the complete default product. This release adds explicit, · budgeted paid-provider escalation for users who bring their own API keys, · without turning configured…

v3.1.2 · 2026-07-22

v3.1.2 (2026-07-22) · Glama quality B→A, npm keywords, CI badge, tool description improvements. · Glama Quality Improvements · Added glama.json with maintainer and related server metadata · Optimized tool descriptions…

04 · Who maintains Agent Search MCP

agent-search-mcp is maintained by lennney. We track 2 MCP servers from lennney - 2 actively maintained, 239 combined GitHub stars, oldest repo from Jun 2026. Full record: all servers from lennney.

mcp-slim-guard 76% fewer MCP tokens in our standard benchmark. Same upstream call. Exact recovery. ★ 132

05 · Facts

repository: github.com/lennney/agent-search-mcp
category: search - ranked #6 of 47 actively-maintained search servers as of 2026-08-25.
release cadence: 7 releases in the last 90 days (latest 2026-08-11)
registry: io.github.lennney/agent-search-mcp (active, first published 2026-07-23 · 3 versions)
packages: npm:agent-search-mcp

06 · Agent Search MCP FAQ

Is Agent Search MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-17 and it shipped 7 releases in the last 90 days. We re-verify nightly.

What can Agent Search MCP do?

With this server connected, an agent can extract a URL as clean Markdown, fetch a public GitHub repository README, fetch a CSDN article, and fetch a Juejin article.

How do I install Agent Search MCP?

Run `npx -y agent-search-mcp`. The README documents one environment variable (HTTP_AUTH_TOKEN) to set first. You can also paste the ready-made client config above.

Does Agent Search MCP run locally?

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

07 · Alternatives to Agent Search MCP

Alternatives to Agent Search MCP

Maintained search servers if Agent Search MCP isn't the fit.

Pairs well with

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

More search MCP servers · Libre Justice · Linkup Platform Linkup MCP Server · Localseodata MCP Server · Sylex Search

More TypeScript MCP servers · Slim Guard · N8n · Letmepost · GraphQL Enhanced · Lex API · see all