FetchV2

FetchV2 MCP Server

[PyPI version] [CI] [Python 3.11+] [License: MIT]

FetchV2 is a Model Context Protocol (MCP) server that retrieves web pages and returns clean Markdown. It uses Trafilatura to remove navigation, advertisements, footers, and other page elements.

What it does

FetchV2 can return raw HTML, preserve links and tables, and paginate long content. The fetch tool checks robots.txt by default.

Quick start

Requirements

1. Install uv.
2. Install Python 3.11 or newer:

uv python install 3.11

Install for Cursor or VS Code

Configure another MCP client

Add this server definition to your MCP client configuration:

{  "mcpServers": {    "fetchv2": {      "command": "uvx",      "args": ["fetchv2-mcp-server@latest"]    }  }}

Common configuration file locations:

• Claude Desktop on macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Desktop on Windows: %APPDATA%\Claude\claude_desktop_config.json
• Windsurf: ~/.codeium/windsurf/mcp_config.json
• Kiro: .kiro/settings/mcp.json in your project

Install in a Python environment

Use one of these commands if you want to install the package directly:

uv add fetchv2-mcp-server

pip install fetchv2-mcp-server

Try it

Ask your MCP client to perform a task such as:

• "Fetch the documentation from <URL>."
• "Find links on <docs URL> that contain tutorial."
• "Read these pages and summarize their differences: [url1, url2, url3]."

Typical documentation workflow

First, find the relevant pages:

discover_links(url="https://docs.example.com/", filter_pattern="/guide/")

Then fetch the selected pages in one request:

fetch_batch(    urls=[        "https://docs.example.com/guide/intro",        "https://docs.example.com/guide/setup",    ])

Tool reference

fetch

Fetch one web page and extract its main content as Markdown.

fetch(    url: str,    max_length: int = 5000,    start_index: int = 0,    get_raw_html: bool = False,    include_metadata: bool = True,    include_tables: bool = True,    include_links: bool = False,    bypass_robots_txt: bool = False,) -> str

If the response is truncated, use the returned start_index value in the next call.

fetch_batch

Fetch up to 10 web pages and combine the results.

fetch_batch(    urls: list[str],    max_length_per_url: int = 2000,    get_raw_html: bool = False,) -> str

This tool reports a failed URL in its result and continues with the other URLs. It does not check robots.txt.

discover_links

Find links on a web page and optionally filter them with a regular expression.

discover_links(url: str, filter_pattern: str = "") -> str

The tool resolves relative links and returns up to 100 URLs.

fetch_llms_txt

Read an llms.txt file and list its documentation links.

fetch_llms_txt(    url: str,    include_content: bool = False,    max_length_per_url: int = 2000,) -> str

By default, this tool fetches only the llms.txt index. Set include_content=True to fetch all linked pages. This option can return a large response.

The tool resolves relative URLs, such as /docs/guide.md, against the llms.txt URL.

Prompts

• fetch_manual creates a request to fetch and summarize one URL.
• research_topic creates a request to research a topic with optional URLs.

Development

Clone the repository and install the development dependencies:

git clone https://github.com/praveenc/fetchv2-mcp-server.gitcd fetchv2-mcp-serveruv sync --dev

Run the tests:

uv run pytest

Run the server with MCP Inspector:

uv run mcp dev src/fetchv2_mcp_server/server.py

Run lint and type checks:

uv run ruff check .uv run pyright

Contributing

Read CONTRIBUTING.md before you submit a change.

Support

Use the GitHub issue tracker to report a problem or request a feature.

License

This project uses the MIT License. See LICENSE for details.