webfetch MCP server
License-first federated image search with attribution, dimensions, and download tooling.
3 stars
Reviews
Write oneNobody has reviewed webfetch yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
webfetch tools (7)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
download_imageDownload an image URL (typically from a prior search_images result) to the local disk cache. Streams with a 20MB hard cap, content-type guard, SHA-256 hash, and returns the cached file path. Host blocklist enforced.
fetch_with_licenseGiven an arbitrary URL (image or webpage), determine its license via host heuristics + page metadata (<link rel=license>, dc.rights, og tags). Set probe: true to also download the bytes. Use when an agent already has a URL and needs a go/no-go decision before shipping.
find_similarReverse-image-search: given a public image URL, find visually similar images. Requires SERPAPI_KEY env var and providers: ['serpapi']. Returns candidates with heuristic licenses — treat results as leads, not shippable.
probe_pageGiven a webpage URL, return every <img> on the page with inferred dimensions and a heuristic license per image. Respects robots.txt by default. Use to triage a candidate source page before picking.
search_album_coverFind canonical album artwork. Uses MusicBrainz Cover Art Archive + iTunes + Spotify. Results are EDITORIAL_LICENSED — safe for album identification UI per platform ToS; always show attribution.
search_artist_imagesSpecialized image search for a musical artist. `kind` selects provider set + query expansion: 'portrait' (Wikimedia + Unsplash + Spotify), 'album' (MusicBrainz CAA + iTunes + Spotify), 'logo' (Wikimedia), 'performing' (Wikimedia + Pexels). Prefer this over `search_images` when building artist/band content.
search_imagesFederated image search across license-aware providers (Wikimedia Commons, Openverse, Unsplash, Pexels, Pixabay, iTunes, MusicBrainz CAA, Spotify, Brave). Returns concise ranked candidates with license + attribution. Does NOT auto-download — call `download_image` after. Default safe-only policy includes open, platform-license, editorial/press tags and rejects UNKNOWN. Use open-only for CC/public-do
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan3 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 80 days ago12/15
- Maintainer identityregistry namespace matches repository owner7/10
Install webfetch in Claude Code, Cursor or VS Code
Runs npx -y getwebfetch-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add webfetch -- npx -y getwebfetch-mcp
What the publisher says
From the webfetch repository's README, as published. We do not edit it. Read it on GitHub
webfetch
The license-first image layer for AI agents and humans.
One MCP server, one CLI, and one HTTP server that federate across 25 image providers, rank results license-first, and reject UNKNOWN results by default. Any agent that speaks MCP (Claude Code, Cursor, Cline, Continue, Roo Code, Codex) wires up from one config line. Landing page, pricing, and hosted usage live at getwebfetch.com.
Install
The curl | bash installer also wires webfetch into Claude Code's ~/.claude/settings.json idempotently. Re-run any time to update.
Surfaces
Package-level API notes live in packages/core/README.md, packages/browser/README.md, and the other package READMEs under packages/.
30-second usage
CLI:
webfetch search "drake portrait" --limit 5
webfetch artist "Taylor Swift" --kind portrait --min-width 1200
webfetch download <url> --out ./portrait.jpg
printf "drake portrait\nradiohead album\n" | webfetch batch --jsonl --continue-on-errorMCP (from inside any MCP-speaking agent):
search_images({ query: "drake portrait", limit: 5 })
search_artist_images({ artist: "Taylor Swift", kind: "portrait" })
download_image({ url: "..." })TypeScript library:
import { searchArtistImages, pickBest, downloadImage } from "webfetch-core";
const { candidates } = await searchArtistImages("Drake", "portrait");
const best = pickBest(candidates, { minWidth: 1200 });
if (best) {
const { cachedPath, sha256 } = await downloadImage(best.url);
console.log(best.attributionLine, "->", cachedPath);
}What problem this solves
Manually sourcing an image has four failure modes:
- You don't know the license, so you can't safely ship the result.
- You can't script it — every new site means another afternoon.
- Google's Image Search API is retired; scraping is brittle and ToS-grey.
- No shared cache — you re-download the same file dozens of times.
webfetch fixes all four by federating across direct-source APIs that have stable terms and structured license metadata, ranking candidates license-first, and exposing the result as a single MCP tool.
Providers
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
webfetch: common questions
- Is webfetch MCP server safe?
- Mostly: it is graded B (77/100). Read the webfetch safety report
- How do I install webfetch?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does webfetch need an API key?
- Yes. The registry entry asks for
UNSPLASH_ACCESS_KEY,PEXELS_API_KEY,PIXABAY_API_KEY,BRAVE_API_KEYand 1 more. - Is webfetch maintained?
- The last commit was 96 days ago (2026-07-10). The latest release is v0.1.5.
- What can I use instead of webfetch?
- Servers from other publishers that do the same job: Brave Search MCP server, Jshookmcp MCP server and Superlocalmemory MCP server. Compare all webfetch alternatives.
Alternatives to webfetch
Same job from other publishers: the closest match first, then the best rated.
- Brave SearchBrave Search MCP Server: web results, images, videos, rich results, AI summaries, and more.not reviewedEstablishedA
- JshookmcpSearch-first MCP server for JavaScript reverse engineering: 735 tools across 36 domains.not reviewedEstablishedC
- SuperlocalmemoryLocal-first AI memory with knowledge graphs and hybrid search. 17+ AI tools via MCP. Free.not reviewedEstablishedC
- BraveVisit https://brave.com/search/api/ for a free API key. Search the web, local businesses, images,…not reviewedEstablishedA
- ArxivSearch arXiv papers, download full text, semantic search, citation graphs, and alerts via MCP.not reviewedEstablishedA