Best for
- Developers and data scientists needing to extract structured data from websites
- Building AI-powered web content analysis tools
- Scenarios requiring CAPTCHA and geo-restriction bypass
O
Oxylabs MCP Server
Official
The missing link between AI models and the real-world web: one API that delivers clean, structured data from any site.
GitHub source repository ↗
59FMRS · C
Oxylabs MCP Server offers powerful scraping and AI data extraction capabilities, suitable for developers needing efficient web data access. Strengths include support for many target sites, automatic JavaScript rendering, built-in CAPTCHA management, and AI-driven tools. Beware of credential configuration and costs.
The Oxylabs MCP server provides a bridge between AI models and the web. It enables them to scrape any URL, render JavaScript-heavy pages, extract and format content for AI use, manage CAPTCHA, and access geo-restricted web data from 195+ countries.
Tools
universal_scraper
Uses Oxylabs Web Scraper API for general website scraping.
google_search_scraper
Uses Oxylabs Web Scraper API to extract results from Google Search.
amazon_search_scraper
Uses Oxylabs Web Scraper API to scrape Amazon search result pages.
amazon_product_scraper
Uses Oxylabs Web Scraper API to extract data from individual Amazon product pages.
ai_scraper
Scrape content from any URL in JSON or Markdown format with AI-powered data extraction.
ai_crawler
Based on a prompt, crawls a website and collects data in Markdown or JSON format across multiple pages.
ai_browser_agent
Based on prompt, controls a browser and returns data in Markdown, JSON, HTML, or screenshot formats.
ai_search
Search the web for URLs and their contents with AI-powered content extraction.
Setup
- Install the uv package manager: macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh; Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex". 2. Add the following JSON configuration to your MCP client config: {"mcpServers":{"oxylabs":{"command":"uvx","args":["oxylabs-mcp"],"env":{"OXYLABS_USERNAME":"YOUR_USERNAME","OXYLABS_PASSWORD":"YOUR_PASSWORD","OXYLABS_AI_STUDIO_API_KEY":"YOUR_API_KEY"}}}}. 3. Ensure you provide at least one set of valid credentials: either OXYLABS_USERNAME and OXYLABS_PASSWORD for the Web Scraper API, or OXYLABS_AI_STUDIO_API_KEY for AI Studio.
claude_desktop_config.json
{
"mcpServers": {
"oxylabs": {
"command": "uvx",
"args": ["oxylabs-mcp"],
"env": {
"OXYLABS_USERNAME": "YOUR_USERNAME",
"OXYLABS_PASSWORD": "YOUR_PASSWORD",
"OXYLABS_AI_STUDIO_API_KEY": "YOUR_API_KEY"
}
}
}
}
Fit and risk
Not for
- Users without an Oxylabs account or credentials
- Those needing to handle extremely complex or heavily anti-scraped sites (may require professional support)
- Cost-sensitive users who need unlimited free usage
Required permissions
- Requires network access to call Oxylabs APIs
- Credentials stored in environment variables (OXYLABS_USERNAME, OXYLABS_PASSWORD, OXYLABS_AI_STUDIO_API_KEY)
Risks and side effects
- Credential leakage risk: avoid hardcoding or committing credentials to public repositories
- API keys may be misused; rotate them regularly
- Scraping may violate website terms of service; assess compliance yourself
- Dependency on external API; failures may occur due to network or service issues
Troubleshooting
- 1. Confirm environment variables are set correctly and no placeholder values remain (placeholders will expose tools that do not work).
- 2. Check network connectivity to ensure access to Oxylabs APIs.
- 3. Inspect logs in notification/message events, e.g., 'Create job' and 'Job info', to diagnose issues.
- 4. If tools are missing, verify the correct credential combination: only Web Scraper credentials expose the first four tools, only AI Studio key exposes the last four, and both expose all tools.
Use cases
Scrape dynamic websites and extract data for AI analysis
Obtain search results from Google, Amazon, and other targets
Automate browser operations via AI agents
Collect structured data from web pages for LLM training or content generation
Supported clients
Claude DesktopFull support