← Back to directory
D

Decodo MCP Server

Official
Enable your AI agents to scrape and parse web content dynamically, including geo-restricted sites
GitHub source repository ↗
★ 34 Stars Category · Dev Tools Popular
57FMRS · C

An officially maintained MCP server that wraps Decodo's commercial Web Scraping API into 30 tools spanning SERP, eCommerce, social media, and AI search, with modular toolsets and geo controls; well suited for production-grade real-time web data in AI agents, though it depends on a third-party cloud service and token auth.

Reliability
7/20
Security and permissions
12/20
Maintenance
9/20
Documentation
16/20
Setup experience
13/20
Read the FMRS scoring method →

The Decodo MCP Server is a web scraping layer for AI agents that connects MCP-compatible clients to Decodo's Web Scraping API. It scrapes websites, search engines, eCommerce platforms, and social media, returning structured outputs in Markdown, JSON, and screenshots, with server-side JavaScript rendering and anti-bot handling backed by 125M+ residential IPs across 195+ locations. Tools are organized into modular toolsets (web, search, ecommerce, social_media, ai) that can be selectively enabled.

Tools

scrape_as_markdown
Scrapes any target URL and returns results in Markdown.
screenshot
Captures a screenshot of any webpage and returns it as a PNG image.
google_search
Scrapes Google Search for a given query and returns parsed results.
google_ads
Scrapes Google Ads search results.
google_lens
Scrapes Google Lens image search results.
google_ai_mode
Scrapes Google AI Mode (Search with AI) results.
google_travel_hotels
Scrapes Google Travel Hotels search results.
amazon_search
Scrapes Amazon Search for a given query and returns parsed results.
amazon_product
Scrapes an Amazon product page.
amazon_pricing
Scrapes Amazon product pricing information.
amazon_sellers
Scrapes Amazon seller information.
amazon_bestsellers
Scrapes the Amazon Bestsellers list.
walmart_search
Scrapes Walmart Search for a given query and returns parsed results.
walmart_product
Scrapes a Walmart product page.
target_search
Scrapes Target Search for a given query and returns parsed results.
target_product
Scrapes a Target product page.
tiktok_post
Scrapes a TikTok post URL for structured data (engagement, caption, hashtags).
tiktok_shop_search
Scrapes TikTok Shop Search for a given query and returns parsed results.
tiktok_shop_product
Scrapes a TikTok Shop product page.
tiktok_shop_url
Scrapes a TikTok Shop page by URL.
youtube_metadata
Scrapes YouTube video metadata.
youtube_channel
Scrapes YouTube channel videos.
youtube_subtitles
Scrapes YouTube video subtitles.
youtube_search
Searches YouTube videos.
reddit_post
Scrapes a specific Reddit post.
reddit_subreddit
Scrapes Reddit subreddit results.
reddit_user
Scrapes a Reddit user profile and their posts/comments.
bing_search
Scrapes Bing Search results.
chatgpt
Search and interact with ChatGPT for AI-powered responses.
perplexity
Search and interact with Perplexity for AI-powered responses.

Setup

  1. Create a free account at dashboard.decodo.com (up to 2K free requests) and get a Web Scraping API basic auth token. 2. Install Node.js 18+. 3. In Claude Desktop's claude_desktop_config., add a server with command npx, args ["-y","@decodo/mcp-server"], env SCRAPER_API_TOKEN set to the token, and optional TOOLSETS such as web,ai. 4. Save and restart the client. Alternatively, use the hosted endpoint https://mcp.decodo.com/mcp with a Basic Authorization header.
claude_desktop_config.json
{"mcpServers":{"Decodo":{"command":"npx","args":["-y","@decodo/mcp-server"],"env":{"SCRAPER_API_TOKEN":"<basic_auth_token>","TOOLSETS":"web,ai"}}}}

Fit and risk

Best for

  • Developers who need real-time web data for LLMs and RAG pipelines
  • Teams building eCommerce intelligence, social monitoring, or price aggregation tools
  • AI agent projects that want production scraping without maintaining proxy infrastructure

Not for

  • Users who cannot rely on a third-party paid scraping service or hosted endpoint
  • Workflows needing only local file or internal data access
  • Privacy-sensitive cases where sending target URLs and prompts to Decodo's servers is unacceptable

Required permissions

  • Requires a Decodo Web Scraping API basic auth token (SCRAPER_API_TOKEN)
  • Downloads and runs the @decodo/mcp-server package via npx from npm
  • Requires network access to call Decodo's hosted scraping service

Risks and side effects

  • All target URLs and prompts pass through a third-party (Decodo) server
  • API usage costs apply once the free quota is exhausted
  • Scraping target sites may violate their terms of service; verify compliance yourself
  • Dependency on an external npm package and hosted API introduces supply-chain and availability risks

Troubleshooting

  1. On auth errors, double-check the token from the dashboard is configured as Basic auth
  2. Verify Node.js 18 or newer is installed
  3. Confirm the MCP client config is saved and the client restarted
  4. If context overflows, ask for fewer tokens or full content in the prompt
  5. For geo-restricted targets, use the geo parameter to change the exit IP country

Use cases

AI-powered web scraping with fresh data instead of static training data
RAG pipelines pulling live Google, Bing, and AI search results
eCommerce intelligence: track prices, listings, and sellers across marketplaces
Social media data collection from Reddit, TikTok, and YouTube
Travel and price aggregation tools
Accessing geo-restricted content

Supported clients

Claude DesktopFull support
CursorFull support
WindsurfFull support
Claude CodePartial support