Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/sydasif/web-search-mcp/claude-mdgit clone --depth 1 https://github.com/sydasif/web-search-mcpWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.01064 | $0.01064 |
| Opus 5 | $0.00532 | $0.00532 |
| Sonnet 5 | $0.00213 | $0.00213 |
| Haiku 4.5 | $0.00106 | $0.00106 |
Grade A, and why
web-search-mcp CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 81 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Design docs → wiki — tool selection guide, design decisions, recommended workflows, tools status, plugin setup, and development standards.
Common Commands
Development
- Install dependencies:
uv sync - Run server:
uv run web-search-mcp(oruv run python -m web_search_mcp.server) - Lint:
uv run ruff check . - Format:
uv run ruff format . - Type check:
uv run mypy .
Testing
- Run all tests:
uv run pytest - Run single test file:
uv run pytest tests/test_module.py - Run specific test:
uv run pytest tests/test_module.py::test_function_name - Run with coverage:
uv run pytest --cov=web_search_mcp
Architecture
High-Level Design
The project is a FastMCP server that exposes a suite of web search and data retrieval tools to LLMs. It follows a "Registry-Implementation" pattern:
- Registry (
server.py): The central point whereFastMCPis initialized and tools are decorated with@mcp.tool. It handles the mapping between MCP tool definitions and the underlying Python implementations. - Implementation Layers:
search/: Implements core web search engines (e.g., DuckDuckGo, Exa).social/: Integrates with community platforms (GitHub, Reddit, Hacker News, X).tools/: Contains specialized utilities (arXiv, Wikipedia).
- Internal Infrastructure (
_prefixed folders):_http/: Centralized HTTP client logic to ensure consistent timeouts, headers, error handling, and SSRF protection (blocks private/internal IP addresses)._models/: Shared Pydantic models for requests and responses to ensure type safety across the server._config/: Manages settings, environment variables, and global rate limits. Seelimits.pyfor hard-coded result depth constraints (e.g.,quick,default,deep) used by social tools._utils/: Low-level helpers for markdown formatting and result scoring.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday First seen · 81 lines · 1,064 tokens per session scan A e6b09196d6c8
web-search-mcp CLAUDE.md is an instructions file published in the GitHub repository sydasif/web-search-mcp (24 stars, last pushed 2d ago), licensed MIT. It adds 1,064 tokens to every session, about $0.0053 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
github-mcp-server copilot-instructions.md
Instructions for github/github-mcp-server, covering github mcp server - copilot instructions, project overview, critical build & validation steps, required commands (run before committing) and when modifying mcp tools/endpoints.
av CLAUDE.md
Instructions for aviator-co/av, covering claude.md, project overview, documentation sources, command structure philosophy and development workflow.
ghtkn AGENTS.md
Instructions for suzuki-shunsuke/ghtkn, a project described as: A CLI to create short-lived (8 hours) GitHub App User Access Token for secure local development.
cc-websearch CLAUDE.md
Instructions for Djarvur/cc-websearch, covering project, constraints, technology stack, what not to add and conventions.
vscode-gitlens CLAUDE.md
Claude Code instructions for gitkraken/vscode-gitlens, a project described as: Supercharge Git inside VS Code and unlock untapped knowledge within each repository — Visualize code authorship at a glance via Git blame annotations and CodeLens, seamlessly navigate and explore Git repositories, gain valuable insights via…
msaccess-vcs-addin AGENTS.md
AGENTS.md instructions for joyfullservice/msaccess-vcs-addin, covering project overview, repository structure, architecture overview, component diagram and key architectural patterns.