Oxylabs MCP Server
Featuredby
Bridge AI models and the internet, delivering clean, structured data from any website through a single API.
Oxylabs MCP Server Overview
What is Oxylabs MCP Server about?
Provides a unified interface that lets large language models request, render, and extract information from any web page, bypassing anti‑scraping defenses and handling geo‑restrictions. It exposes two families of tools—Web Scraper API tools and AI Studio tools—so the same server can be used for raw scraping or AI‑enhanced extraction.
How to use Oxylabs MCP Server?
- Install the package (recommended via
uvxoruv, or simplypip install oxylabs-mcp). - Set environment variables for the credentials you have:
OXYLABS_USERNAME&OXYLABS_PASSWORDfor the Web Scraper API.OXYLABS_AI_STUDIO_API_KEYfor the AI Studio API.
- Run the server using your preferred launcher (e.g.,
uvx oxylabs-mcporuv run oxylabs-mcp). - Configure your AI client (Claude Desktop, Cursor AI, Smithery, etc.) with the generated MCP endpoint and, if needed, OAuth2 or query‑parameter authentication.
- Call tools via the Model Context Protocol – select any of the eight tools (e.g.,
ai_scraper,google_search_scraper) and provide required parameters such asurl.
Key Features
- Dual tool sets: raw Web Scraper API utilities and AI‑driven extraction/crawling agents.
- Automatic JavaScript rendering with headless Chrome for SPA pages.
- Built‑in parsers for Google Search, Amazon search and product pages.
- Geo‑IP rotation covering 195+ countries and robust bot‑shield bypass.
- Output formats: JSON, Markdown, HTML, screenshots.
- Seamless logging via
notifications/messageevents for debugging. - Flexible deployment: uvx, uv, Smithery Oauth2, or direct URL with credentials.
Use Cases
- Research assistants: Summarise news, forum threads, or product reviews on‑the‑fly.
- E‑commerce intelligence: Harvest pricing, stock, and review data from Amazon or other marketplaces.
- Competitive analysis: Pull structured data from competitor sites that use heavy JavaScript.
- Geo‑specific data collection: Access region‑locked content (e.g., local news, government portals) without manual proxy management.
- AI‑augmented agents: Feed clean, AI‑ready content directly into LLM prompts for downstream reasoning.
FAQ
- Do I need both the Web Scraper API and AI Studio credentials? No. Provide whichever you have; the server will expose only the corresponding tools.
- What happens if I leave placeholder values in the environment variables? The server will expose tools that cannot authenticate, resulting in runtime errors. Remove unused placeholders.
- Which operating systems are supported? macOS, Linux, and Windows (via uv/uvx or standard Python installation).
- How are errors reported?
Errors are sent as
notifications/messageevents withlevel: "error"and a descriptive message. - Can I control rendering mode? Yes, each tool allows you to choose full JavaScript rendering, HTML‑only, or none via tool‑specific parameters.
Oxylabs MCP Server's README
📖 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.
🛠️ MCP Tools
Oxylabs MCP provides two sets of tools that can be used together or independently:
Oxylabs Web Scraper API 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.
Oxylabs AI Studio Tools
- 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.
✅ Prerequisites
Before you begin, make sure you have at least one of the following:
- Oxylabs Web Scraper API Account: Obtain your username and password from Oxylabs (1-week free trial available);
- Oxylabs AI Studio API Key: Obtain your API key from Oxylabs AI Studio. (1000 credits free).
📦 Configuration
Environment variables
Oxylabs MCP server supports the following environment variables:
| Name | Description | Default |
|---|---|---|
OXYLABS_USERNAME |
Your Oxylabs Web Scraper API username | |
OXYLABS_PASSWORD |
Your Oxylabs Web Scraper API password | |
OXYLABS_AI_STUDIO_API_KEY |
Your Oxylabs AI Studio API key | |
LOG_LEVEL |
Log level for the logs returned to the client | INFO |
Based on provided credentials, the server will automatically expose the corresponding tools:
- If only
OXYLABS_USERNAMEandOXYLABS_PASSWORDare provided, the server will expose the Web Scraper API tools; - If only
OXYLABS_AI_STUDIO_API_KEYis provided, the server will expose the AI Studio tools; - If both
OXYLABS_USERNAMEandOXYLABS_PASSWORDandOXYLABS_AI_STUDIO_API_KEYare provided, the server will expose all tools.
❗❗❗ Important note: if you don't have Web Scraper API or Oxylabs AI studio credentials, delete the corresponding environment variables placeholders. Leaving placeholder values will result in exposed tools that do not work.
Configure with uvx
- Install the uvx package manager:
OR:# macOS and Linux curl -LsSf https://astral.sh/uv/install.sh | sh# Windows powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" - Use the following config:
{ "mcpServers": { "oxylabs": { "command": "uvx", "args": ["oxylabs-mcp"], "env": { "OXYLABS_USERNAME": "OXYLABS_USERNAME", "OXYLABS_PASSWORD": "OXYLABS_PASSWORD", "OXYLABS_AI_STUDIO_API_KEY": "OXYLABS_AI_STUDIO_API_KEY" } } } }
Configure with uv
-
Install the uv package manager:
# macOS and Linux curl -LsSf https://astral.sh/uv/install.sh | shOR:
# Windows powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" -
Use the following config:
{ "mcpServers": { "oxylabs": { "command": "uv", "args": [ "--directory", "/<Absolute-path-to-folder>/oxylabs-mcp", "run", "oxylabs-mcp" ], "env": { "OXYLABS_USERNAME": "OXYLABS_USERNAME", "OXYLABS_PASSWORD": "OXYLABS_PASSWORD", "OXYLABS_AI_STUDIO_API_KEY": "OXYLABS_AI_STUDIO_API_KEY" } } } }
Configure with Smithery Oauth2
- Go to https://smithery.ai/server/@oxylabs/oxylabs-mcp;
- Click Auto to install the Oxylabs MCP configuration for the respective client;
- OR use the following config:
{
"mcpServers": {
"oxylabs": {
"url": "https://server.smithery.ai/@oxylabs/oxylabs-mcp/mcp"
}
}
}
- Follow the instructions to authenticate Oxylabs MCP with Oauth2 flow
Configure with Smithery query parameters
In case your client does not support the Oauth2 authentication, you can pass the Oxylabs authentication parameters directly in url
{
"mcpServers": {
"oxylabs": {
"url": "https://server.smithery.ai/@oxylabs/oxylabs-mcp/mcp?oxylabsUsername=OXYLABS_USERNAME&oxylabsPassword=OXYLABS_PASSWORD&oxylabsAiStudioApiKey=OXYLABS_AI_STUDIO_API_KEY"
}
}
}
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.
📝 Logging
Server provides additional information about the tool calls in notification/message events
{
"method": "notifications/message",
"params": {
"level": "info",
"data": "Create job with params: {\"url\": \"https://ip.oxylabs.io\"}"
}
}
{
"method": "notifications/message",
"params": {
"level": "info",
"data": "Job info: job_id=7333113830223918081 job_status=done"
}
}
{
"method": "notifications/message",
"params": {
"level": "error",
"data": "Error: request to Oxylabs API failed"
}
}
🛡️ License
Distributed under the MIT License – see LICENSE for details.
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.
✨ 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 more
- 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
Why Oxylabs MCP? 🕸️ ➜ 📦 ➜ 🤖
Imagine telling your LLM "Summarise the latest Hacker News discussion about GPT‑5" – and it simply answers.
MCP (Multi‑Client Proxy) makes that happen by doing the boring parts for you:
| What Oxylabs MCP does | Why it matters to you |
|---|---|
| Bypasses anti‑bot walls with the Oxylabs global proxy network | Keeps you unblocked and anonymous |
| Renders JavaScript in headless Chrome | Single‑page apps, sorted |
| Cleans HTML → JSON | Drop straight into vector DBs or prompts |
| Optional structured parsers (Google, Amazon, etc.) | One‑line access to popular targets |
Oxylabs MCP Server Reviews
Login Required
Please log in to share your review and rating for this MCP.
Actions
Oxylabs MCP Server's Information
- Author
- oxylabs
- Category
- Web Scraping
- Language
- Python
- License
- MIT License
- Stars
- 63
- Updated
- about 1 month ago
Related MCP Servers
Discover more MCP servers with similar functionality and use cases
Firecrawl MCP Server
by firecrawl
Adds powerful web scraping, crawling, and search capabilities to LLM clients through a Model Context Protocol (MCP) server.
FireCrawl
Officialby mendableai
Firecrawl MCP Server is an official Model Context Protocol (MCP) server implementation that integrates with Firecrawl to provide powerful web scraping capabilities to Large Language Models (LLMs). It acts as a bridge between LLMs and the web, allowing them to access and process web content for various tasks.
Tavily MCP
by tavily-ai
Provides real-time web search, intelligent data extraction, site mapping, and crawling capabilities via MCP tools.
RedNote MCP
by iFurySt
RedNote-MCP is an MCP server designed to access content from RedNote (XiaoHongShu, xhs), a popular Chinese social media and e-commerce platform. It enables programmatic interaction with RedNote for data retrieval and automation.
Fetch
by zcaceres
fetch-mcp is a flexible HTTP fetching server designed to retrieve web content in various formats. It acts as a server that can fetch HTML, JSON, Markdown, or plaintext from specified URLs, enabling on-demand fetching and transformation of web content.
Apify
Officialby apify
An MCP server for Apify Actors, allowing AI assistants to use any of the 3,000+ pre-built cloud tools for web scraping and automation.
Airbnb
by openbnb-org
The mcp-server-airbnb is an MCP (Multi-Cloud Platform) server designed to interact with Airbnb. It provides tools for searching Airbnb listings and retrieving detailed information about specific listings.
SEO MCP
by cnych
A free SEO tool MCP (Model Control Protocol) service based on Ahrefs data, offering features like backlink analysis, keyword research, and traffic estimation.
AgentQL
Officialby tinyfish-io
AgentQL MCP Server is a Model Context Protocol (MCP) server that integrates AgentQL's data extraction capabilities, enabling AI agents to get structured data from the unstructured web.