Decodo MCP
io.github.Decodo · Updated
Enable your AI agents to scrape and parse web content dynamically, including geo-restricted sites
At a glance
Decodo MCP is an MCP server in the Dev Tools & Git category. It runs locally over stdio via `npx -y @decodo/mcp-server`, and declares no required credentials. It exposes 33 tools, including scrape_as_markdown, screenshot and map. It scores A (85/100) on the MCP Skills Hub health score as of Oct 28, 2026.
One-click install
Opens your editor and pre-fills the config. Your editor will ask before adding it.
How to install Decodo MCP in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install Decodo MCP in Claude CodeAnthropic's agentic CLI
Add the server
bashclaude mcp add Decodo -- npx -y @decodo/mcp-serverVerify it's connected
bashclaude mcp listSharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes (e.g. scrape_as_markdown, screenshot, map). It discovers them automatically.
How to install Decodo MCP in Claude DesktopDesktop app (MCP config)
Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json
Add this server
json{ "mcpServers": { "Decodo": { "command": "npx", "args": [ "-y", "@decodo/mcp-server" ] } } }Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.
How to install Decodo MCP in CursorAI-first code editor
Create / edit .cursor/mcp.json in your project
json{ "mcpServers": { "Decodo": { "command": "npx", "args": [ "-y", "@decodo/mcp-server" ] } } }Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.
How to install Decodo MCP in Codex CLIOpenAI coding agent
Add to ~/.codex/config.toml
toml[mcp_servers.Decodo] command = "npx" args = ["-y", "@decodo/mcp-server"]Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.
How to install Decodo MCP in WindsurfCodeium's agentic IDE
Edit ~/.codeium/windsurf/mcp_config.json
json{ "mcpServers": { "Decodo": { "command": "npx", "args": [ "-y", "@decodo/mcp-server" ] } } }Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.
How to install Decodo MCP in ClineVS Code autonomous agent
Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.
Add the server
json{ "mcpServers": { "Decodo": { "command": "npx", "args": [ "-y", "@decodo/mcp-server" ] } } }
How to install Decodo MCP in VS CodeCopilot / MCP support
Create .vscode/mcp.json
json{ "servers": { "Decodo": { "type": "stdio", "command": "npx", "args": [ "-y", "@decodo/mcp-server" ] } } }Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.
What tools does Decodo MCP expose? (33)
Taken from the project's README — the server itself was not queried, so check its docs for the exact schemas.
- scrape_as_markdownScrapes any target URL, expects a URL to be given via prompt. Returns results in Markdown.
- screenshotCaptures a screenshot of any webpage and returns it as a PNG image.
- mapLists the URLs on a website without fetching their content. API key only.
- crawl_startStarts crawling a website and returns the crawl id without waiting. API key only.
- crawl_statusReports a crawl's progress: pages discovered, completed and failed. API key only.
- crawl_resultsReturns crawled pages as Markdown, a few at a time with a cursor. API key only.
- crawl_cancelStops a running crawl; pages crawled so far stay readable. API key only.
- searchSearches the web and returns ranked results. API key only.
- google_searchScrapes Google Search for a given query, and returns parsed results.
- google_adsScrapes Google Ads search results.
- google_lensScrapes Google Lens image search results.
- google_ai_modeScrapes Google AI Mode (Search with AI) results.
- google_travel_hotelsScrapes Google Travel Hotels search results.
- amazon_searchScrapes Amazon Search for a given query, and returns parsed results.
- amazon_productScrapes Amazon Product page.
- amazon_pricingScrapes Amazon Product pricing information.
- amazon_sellersScrapes Amazon Seller information.
- amazon_bestsellersScrapes Amazon Bestsellers list.
- walmart_searchScrapes Walmart Search for a given query, and returns parsed results.
- walmart_productScrapes Walmart Product page.
- target_searchScrapes Target Search for a given query, and returns parsed results.
- target_productScrapes Target Product page.
- tiktok_postScrapes a TikTok post URL for structured data (e.g. engagement, caption, hashtags).
- tiktok_shop_searchScrapes TikTok Shop Search for a given query, and returns parsed results.
- tiktok_shop_productScrapes TikTok Shop Product page.
- tiktok_shop_urlScrapes TikTok Shop page by URL.
- youtube_metadataScrapes YouTube video metadata.
- youtube_channelScrapes YouTube channel videos.
- youtube_subtitlesScrapes YouTube video subtitles.
- youtube_searchSearch YouTube videos.
- bing_searchScrapes Bing Search results.
- chatgptSends a single prompt to ChatGPT and returns its answer (no conversation history).
- perplexitySends a single prompt to Perplexity and returns its answer (no conversation history).
What the code can do
Read from the published package source — never executed. Parsed 80 of 112 source files.
This server can read and write files and read your environment variables.
How it was published
- Published by a verified CI identity (github trusted publishing) rather than a personal token.
- Has a provenance attestation tying this artifact to the commit it was built from.
- 1 npm maintainer — a single point of compromise · last published by GitHub Actions.
Maintainer of this package and think something here is wrong? Tell us and we'll correct it.
Before you install
Signals gathered from the source repo and package registry — not a safety verdict.
What it can reach
- Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
- Downloads at launch — The package is fetched from its registry each run unless you pin a version.
- Last commit today — Actively maintained.
- 39 GitHub stars — Community adoption signal.
- No license declared — Without a license the code is not legally reusable in a commercial project.
Client compatibility
Health score
A · 85Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated
- Maintenance30%100%
Last commit 0 days ago.
- Adoption20%49%
39 stars.
- Transparency20%75%
3/4: ✓ public source repo, ✗ declared license, ✓ documentation, ✓ discoverable tool list.
- Provenance15%100%
Package and registry entry point at the same repository.
- Packaging15%100%
Publishes a pinned version (1.7.0).
Documentation
Full READMEDecodo MCP Server
Connect LLMs and AI agents to live web data using MCP (Model Context Protocol). The Decodo MCP Server lets you scrape websites, search engines, eCommerce platforms, and social media directly from AI tools like Claude, Cursor, and Windsurf, all without the need to build scraping infrastructure from scratch.
- Structured outputs in JSON, Markdown, and screenshots
- Server-side JavaScript rendering and anti-bot handling
- 125M+ IPs across 195+ locations
What is Decodo MCP server?
The Decodo MCP Server is a web scraping layer for AI agents. It connects MCP-compatible clients to Decodo's Web Scraping API, enabling:
- Web scraping for LLMs
- Real-time data retrieval for RAG
- AI agent browsing and research
- Structured data extraction from dynamic websites
Instead of maintaining proxies, parsers, and retry logic, you get a single integration point for reliable web data access.
Why use MCP for web scraping?
Model Context Protocol (MCP) is the emerging standard for connecting AI agents to external tools and data sources. With MCP:
- Agents can call tools dynamically
- Integrations stay standardized
- Workflows scale across environments
The Decodo MCP Server gives your agents reliable, production-ready web access through this standard.
Key features
Web scraping for AI agents, no infrastructure required. Scrape any website, including JavaScript-heavy pages, without handling proxy rotation, CAPTCHA solving, or anti-bot systems.
Structured outputs for LLM workflows. Markdown (LLM-ready), JSON (for structured pipelines), and screenshots (for visual context), built for RAG pipelines, AI research agents, and automation flows.
Excerpt — the full document is on GitHub.
Alternatives to Decodo MCP
- Pagerunner — The Browser Layer That LearnsA · 84Real Chrome profiles with site intelligence — already logged in, PII anonymization, sessions persist
- playwright-mcp-serverC · 40Headless browser primitives for AI agents when sites need real JS rendering.
- SocialToAIB · 76Social media data for AI agents: one MCP address, 18 platforms. Pay per call; failed calls are free.
- agbrowserD · 33Browser sessions for agents: navigate, interact, read and screenshot. Pay in stablecoins.
Maintain Decodo MCP? Add a badge to your README
Shows its health grade, and links readers to install steps for every client.
[](https://mcp-skills-hub.vercel.app/mcps/io-github-decodo-mcp-server)Catalog data refreshed . Something wrong? Report it.