Oxylabs Mcp Server

What is Oxylabs MCP?

Oxylabs MCP (Managed Cloud Proxy) is a powerful solution designed to provide users with smooth access to web data through a network of residential and data center proxies. This service is aimed at businesses and developers who need reliable and efficient web scraping capabilities, ensuring they can collect data from various online sources without facing blocks or restrictions.

Features of Oxylabs MCP

Extensive Proxy Network: Oxylabs MCP features a large network of over 100 million residential IPs and data center proxies, enabling users to access geo-targeted content and bypass restrictions.
High Anonymity: The service guarantees user anonymity, making it hard for websites to detect scraping activities, thus lowering the risk of IP bans.
User-Friendly Dashboard: The easy-to-use dashboard allows users to manage their proxy settings, usage statistics, and billing information effortlessly.
Flexible Pricing Plans: Oxylabs offers a variety of pricing plans to meet different needs, whether for small projects or large-scale data scraping operations.
24/7 Customer Support: Users have access to round-the-clock support to help with any issues or questions regarding the service.

How to Use Oxylabs MCP

Sign Up: Create an account on the Oxylabs website to access the MCP service.
Choose a Plan: Select a pricing plan that suits your data scraping needs.
Configure Your Proxies: Use the dashboard to set up your proxy configurations, including choosing the type of proxies you need (residential or data center).
Integrate with Your Application: Use the provided API or integration tools to connect Oxylabs MCP with your web scraping application.
Start Scraping: Begin your data collection process, making sure to monitor usage and performance through the dashboard.

Frequently Asked Questions

Q: What types of proxies does Oxylabs MCP offer?

A: Oxylabs MCP provides both residential and data center proxies, allowing users to choose based on their specific scraping needs.

Q: Is there a limit to how much data I can scrape?

A: The limits depend on the pricing plan you choose. Each plan has its own data allowance, so it's important to select one that matches your scraping requirements.

Q: Can I use Oxylabs MCP for SEO purposes?

A: Yes, many users utilize Oxylabs MCP for SEO tasks such as rank tracking, competitor analysis, and market research, thanks to its ability to access localized data.

Q: What happens if my IP gets blocked?

A: Oxylabs MCP is designed to reduce the risk of IP bans through its rotating proxy feature, which automatically changes your IP address at set intervals or after each request.

Q: How do I contact customer support?

A: You can contact Oxylabs customer support via the contact form on their website or through the live chat feature available in the dashboard.

<img src="https://storage.googleapis.com/oxylabs-public-assets/oxylabs_mcp.svg" alt="Oxylabs + MCP"> <h1 align="center" style="border-bottom: none;"> Oxylabs MCP Server </h1> The missing link between AI models and the real‑world web: one API that delivers clean, structured data from any site. <div align="center">

📖 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.

Why Oxylabs MCP? 🕸️ ➜ 📦 ➜ 🤖

Imagine telling your LLM "Summarise the latest Hacker News discussion about GPT‑7" – 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 |

✨ Key Features

<details> <summary> Scrape content from any site</summary>

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

</details> <details> <summary> Automatically get AI-ready data</summary>

Automatically clean and convert HTML to Markdown for improved readability
Use automated parsers for popular targets like Google, Amazon, and etc.

</details> <details> <summary> Bypass blocks & geo-restrictions</summary>

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

</details> <details> <summary> Flexible setup & cross-platform support</summary>

Set rendering and parsing options if needed
Feed data directly into AI models or analytics tools
Works on macOS, Windows, and Linux

</details> <details> <summary> Built-in error handling and request management</summary>

Comprehensive error handling and reporting
Smart rate limiting and request management

</details>

🛠️ MCP Tools

Oxylabs MCP provides the following 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.

💡 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 Universal Scraper accepts these parameters:

| Parameter | Description | Values | |-|-|| | url | The URL to scrape | Any valid URL | | render | Use headless browser rendering | html or None | | geo_location | Sets the proxy's geo location to retrieve data. | Brasil, Canada, etc. | | user_agent_type | Device type and browser | desktop, tablet, etc. | | output_format | The format of the output | links, md, html |

🔧 Configuration

<details> <summary><code>smithery</code></summary>

Go to https://smithery.ai/server/@oxylabs/oxylabs-mcp
Login with GitHub
Find the Install section
Follow the instructions to generate the config

Auto install with Smithery CLI

### example for Claude Desktop
npx -y @smithery/cli@latest install @upstash/context7-mcp --client claude --key <smithery_key>

</details> <details> <summary><code>uvx</code></summary>

Install the uv

### 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"
      }
    }
  }
}

</details> <details> <summary><code>uv</code></summary>

Install the uvx

### 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": "uv",
      "args": [
        "--directory",
        "/<Absolute-path-to-folder>/oxylabs-mcp",
        "run",
        "oxylabs-mcp"
      ],
      "env": {
        "OXYLABS_USERNAME": "OXYLABS_USERNAME",
        "OXYLABS_PASSWORD": "OXYLABS_PASSWORD"
      }
    }
  }
}

</details>

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.

⚙️ Environment variables

Oxylabs MCP server supports the following environment variables

| Name | Description | Mandatory | Default | |--|--||| | OXYLABS_USERNAME | Your Oxylabs username | true | | | OXYLABS_PASSWORD | Your Oxylabs password | true | | | LOG_LEVEL | Log level for the logs returned to the client | false | INFO |

📝 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.

<div align="center"> Made with ☕ by <a href="https://oxylabs.io">Oxylabs</a>. Feel free to give us a ⭐ if MCP saved you a weekend. </div>

Overview