Fetch URL MCP Server

Fetch URL MCP Server

An MCP server that fetches web pages and converts them to clean, readable Markdown.

Overview

This server takes a URL, fetches the page, and strips away everything you don't need — navigation, sidebars, banners, scripts — leaving just the main content as Markdown. It's perfect for feeding into LLMs, giving them the distilled essence of a page without the noise. It also recognizes GitHub, GitLab, Bitbucket, and Gist URLs and rewrites them to fetch the raw content directly.

By default it runs over stdio. Pass --http if you need a proper HTTP endpoint with auth, rate limiting, TLS, and session support.

Key Features

• HTML to Markdown — Turns any public web page into clean, readable Markdown with metadata like title, url, contentSize, and truncated.
• Smart URL handling — Recognizes GitHub, GitLab, Bitbucket, and Gist page URLs and rewrites them to raw-content endpoints before fetching.
• Task mode — Big or slow pages can run as async MCP tasks with progress updates, instead of blocking. In HTTP mode, tasks are bound to the authenticated caller rather than a single MCP session, so they can be resumed after reconnecting as the same authenticated subject. Polling task state exposes task summaries; numeric progress remains out-of-band via notifications/progress.
• Self-documenting — Includes an internal://instructions resource and a get-help prompt so clients know how to use it.
• HTTP mode — Optionally serves over Streamable HTTP with host/origin validation, bearer or OAuth auth, rate limiting, health checks, and TLS.

Web Client

A browser-based client is available if you want to use the server without any MCP setup.

[Live app](https://fetch-url-client.vercel.app) · Source code

Requirements

• Node.js >= 24
• Docker (optional) — only needed if you want to run the container image

Quick Start

Add this to your MCP client config:

{

"mcpServers": { "fetch-url-mcp": { "command": "npx", "args": ["-y", "@j0hanz/fetch-url-mcp@latest"] } } }

Client Configuration

Install in VS Code

Add to .vscode/mcp.json:

{

"servers": { "fetch-url-mcp": { "type": "stdio", "command": "npx", "args": ["-y", "@j0hanz/fetch-url-mcp@latest"] } } }

Or install via CLI:

code --add-mcp '{"name":"fetch-url-mcp","command":"npx","args":["-y","@j0hanz/fetch-url-mcp@latest"]}'

For more info, see VS Code MCP docs.

Install in VS Code Insiders

Add to .vscode/mcp.json:

{

"servers": { "fetch-url-mcp": { "type": "stdio", "command": "npx", "args": ["-y", "@j0hanz/fetch-url-mcp@latest"] } } }

Or install via CLI:

code-insiders --add-mcp '{"name":"fetch-url-mcp","command":"npx","args":["-y","@j0hanz/fetch-url-mcp@latest"]}'

For more info, see VS Code Insiders MCP docs.

Install in Cursor

Add to ~/.cursor/mcp.json:

{

"mcpServers": { "fetch-url-mcp": { "command": "npx", "args": ["-y", "@j0hanz/fetch-url-mcp@latest"] } } }

For more info, see Cursor MCP docs.

Install in Visual Studio

For solution-scoped setup, add this to .mcp.json at the solution root:

{

"servers": { "fetch-url-mcp": { "type": "stdio", "command": "npx", "args": ["-y", "@j0hanz/fetch-url-mcp@latest"] } } }

For more info, see Visual Studio MCP docs.

Install in Goose

Add to ~/.config/goose/config.yaml on macOS/Linux or %APPDATA%\Block\goose\config\config.yaml on Windows:

extensions:

fetch-url-mcp: name: fetch-url-mcp cmd: npx args: ['-y', '@j0hanz/fetch-url-mcp@latest'] enabled: true type: stdio timeout: 300

For more info, see Goose extension docs.

Install in LM Studio

Add to ~/.lmstudio/mcp.json on macOS/Linux or %USERPROFILE%/.lmstudio/mcp.json on Windows:

{

"mcpServers": { "fetch-url-mcp": { "command": "npx", "args": ["-y", "@j0hanz/fetch-url-mcp@latest"] } } }

For more info, see LM Studio MCP docs.

Install in Claude Desktop

Add to claude_desktop_config.json:

{

"mcpServers": { "fetch-url-mcp": { "command": "npx", "args": ["-y", "@j0hanz/fetch-url-mcp@latest"] } } }

For more info, see Claude Desktop MCP docs.

Install in Claude Code

Use the CLI:

claude mcp add fetch-url-mcp -- npx -y @j0hanz/fetch-url-mcp@latest

For project-scoped config, Claude Code writes .mcp.json with:

{

"mcpServers": { "fetch-url-mcp": { "command": "npx", "args": ["-y", "@j0hanz/fetch-url-mcp@latest"], "env": {} } } }

For more info, see Claude Code MCP docs.

Install in Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{

"mcpServers": { "fetch-url-mcp": { "command": "npx", "args": ["-y", "@j0hanz/fetch-url-mcp@latest"] } } }

For more info, see Windsurf MCP docs.

Install in Amp

Add to ~/.config/amp/settings.json on macOS/Linux, %USERPROFILE%\.config\amp\settings.json on Windows, or .amp/settings.json for workspace-scoped config:

{

"amp.mcpServers": { "fetch-url-mcp": { "command": "npx", "args": ["-y", "@j0hanz/fetch-url-mcp@latest"] } } }

Or install via CLI:

amp mcp add fetch-url-mcp -- npx -y @j0hanz/fetch-url-mcp@latest

For more info, see Amp docs.

Install in Cline

Open the MCP Servers panel, choose Configure MCP Servers, and add this to cline_mcp_settings.json:

{

"mcpServers": { "fetch-url-mcp": { "command": "npx", "args": ["-y", "@j0hanz/fetch-url-mcp@latest"] } } }

For more info, see Cline MCP docs.

Install in Codex CLI

Use the CLI:

codex mcp add fetch-url-mcp -- npx -y @j0hanz/fetch-url-mcp@latest

Or add this to ~/.codex/config.toml or project-scoped .codex/config.toml:

[mcp_servers.fetch-url-mcp]

command = "npx" args = ["-y", "@j0hanz/fetch-url-mcp@latest"]

For more info, see Codex MCP docs.

Install in GitHub Copilot

Add to .vscode/mcp.json:

{

"servers": { "fetch-url-mcp": { "type": "stdio", "command": "npx", "args": ["-y", "@j0hanz/fetch-url-mcp@latest"] } } }

For more info, see GitHub Copilot MCP docs.

Install in Warp

Open Personal > MCP Servers in Warp, choose + Add, and either add a CLI server with:

• command: npx
• args: ["-y", "@j0hanz/fetch-url-mcp@latest"]

Or paste this JSON snippet when using Warp's multi-server import flow:

{

"mcpServers": { "fetch-url-mcp": { "command": "npx", "args": ["-y", "@j0hanz/fetch-url-mcp@latest"] } } }

For more info, see Warp MCP docs.

Install in Kiro

Use Kiro's MCP Servers panel or the Add to Kiro install flow. Kiro stores workspace-scoped MCP config in .kiro/settings/mcp.json and user-scoped config in ~/.kiro/settings/mcp.json.

For this server, use:

• command: npx
• args: ["-y", "@j0hanz/fetch-url-mcp@latest"]

For more info, see Kiro MCP docs.

Install in Gemini CLI

Add to ~/.gemini/settings.json:

{

"mcpServers": { "fetch-url-mcp": { "command": "npx", "args": ["-y", "@j0hanz/fetch-