The Oxylabs MCP Server enables AI models to interact with web content by scraping and processing data from any URL. Key capabilities include:
- Scrape content from any site, including JavaScript-heavy single-page applications
- Process data into AI-ready formats by cleaning HTML and converting to Markdown
- Extract structured data using automated parsers for popular sites like Google and Amazon
- Bypass protection systems and access geo-restricted content using proxies from 195+ countries
- Configure rendering options with flexible setup for headless browsing or direct scraping
- Integrate across platforms with macOS, Windows, and Linux support
- Handle errors intelligently with built-in error reporting and smart rate limiting
📖 Overview
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, bypass anti-scraping measures, and access geo-restricted web data from 195+ countries.
This implementation leverages the Model Context Protocol (MCP) to create a secure, standardized way for AI assistants to interact with web content.
✨ Key Features
- Extract data from any URL, including complex single-page applications
- Fully render dynamic websites using headless browser support
- Choose full JavaScript rendering, HTML-only, or none
- Emulate Mobile and Desktop viewports for realistic rendering
- Automatically clean and convert HTML to Markdown for improved readability
- Use automated parsers for popular targets like Google, Amazon, and etc.
- Bypass sophisticated bot protection systems with high success rate
- Reliably scrape even the most complex websites
- Get automatically rotating IPs from a proxy pool covering 195+ countries
- Set rendering and parsing options if needed
- Feed data directly into AI models or analytics tools
- Works on macOS, Windows, and Linux
- Comprehensive error handling and reporting
- Smart rate limiting and request management
💡 Example Queries
When you've set up the MCP server with Claude, you can make requests like:
- Could you scrape
https://www.google.com/search?q=ai
page? - Scrape
https://www.amazon.de/-/en/Smartphone-Contract-Function-Manufacturer-Exclusive/dp/B0CNKD651V
with parse enabled - Scrape
https://www.amazon.de/-/en/gp/bestsellers/beauty/ref=zg_bs_nav_beauty_0
with parse and render enabled - Use web unblocker with render to scrape
https://www.bestbuy.com/site/top-deals/all-electronics-on-sale/pcmcat1674241939957.c
✅ Prerequisites
Before you begin, make sure you have:
- Oxylabs Account: Obtain your username and password from Oxylabs (1-week free trial available)
Basic Usage
Via Smithery CLI:
- Node.js (v16+)
npx
command-line tool
Via uv:
uv
package manager – install it using this guide
Local/Dev Setup
- Python 3.12+
uv
package manager – install it using this guide
🧩 API Parameters
The Oxylabs MCP server supports these parameters:
Parameter | Description | Values |
---|---|---|
url | The URL to scrape | Any valid URL |
parse | Enable structured data extraction | True or False |
render | Use headless browser rendering | html or None |
⚙️ Basic Setup Instructions
Install via Smithery
Automatically install Oxylabs MCP server via Smithery:
List of clients supported by Oxylabs at the moment:
- claude
- cursor
Manual MCP configuration options
- Config with
uvx
. Will install the CLI client and Oxylabs MCP server that performs calls directly to the Oxylabs API. Recommended and the most stable option at the moment. - Config with
npx
. Will install the Smithery CLI client that performs calls to the Oxylabs MCP server hosted in Smithery. - Config with
uv
. Will install CLI client and Oxylabs MCP server that references the local code. For the local development.
Note
If you don't have uvx
utility you need to install it first with brew install uv
Tip
If you run into errors with uvx
, try using the full path to uvx
in the command
field. For example, /Users/my-user/.local/bin/uvx
.
If you are using Windows and experiencing issues with Cursor, refer to the guidelines described here.
Manual Setup with Claude Desktop
Navigate to Claude → Settings → Developer → Edit Config and add one of the configurations above to the claude_desktop_config.json
file.
Manual Setup with Cursor AI
Navigate to Cursor → Settings → Cursor Settings → MCP. Click Add new global MCP server and add one of the configurations above.
💻 Local/Dev Setup Instructions
Clone repository
Install dependencies
Install MCP server dependencies:
🐞 Debugging
Then access MCP Inspector at http://localhost:5173
. You may need to add your username and password as environment variables in the inspector under OXYLABS_USERNAME
and OXYLABS_PASSWORD
.
License
This project is licensed under the MIT License.
About Oxylabs
Established in 2015, Oxylabs is a market-leading web intelligence collection platform, driven by the highest business, ethics, and compliance standards, enabling companies worldwide to unlock data-driven insights.
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A scraper tool that leverages the Oxylabs Web Scraper API to fetch and process web content with flexible options for parsing and rendering pages, enabling efficient content extraction from complex websites.
- ✨ Key Features
- 💡 Example Queries
- ✅ Prerequisites
- 🧩 API Parameters
- ⚙️ Basic Setup Instructions
- 💻 Local/Dev Setup Instructions
- License
- About Oxylabs
Related Resources
Related MCP Servers
- AsecurityFlicenseAqualityA server that provides tools to scrape websites and extract structured data from them using Firecrawl's APIs, supporting both basic website scraping in multiple formats and custom schema-based data extraction.Last updated -2JavaScript
- -securityFlicense-qualityProvides functionality to fetch and transform web content in various formats (HTML, JSON, plain text, and Markdown) through simple API calls.Last updated -125,855TypeScript
- AsecurityFlicenseAqualityInteract with WebScraping.AI API for web data extraction and scrapingLast updated -7852JavaScript
- -securityFlicense-qualityEnables intelligent web scraping through a browser automation tool that can search Google, navigate to webpages, and extract content from various websites including GitHub, Stack Overflow, and documentation sites.Last updated -1Python