Oxylabs

v1.0.0Search & Data Extractionstable

Official Oxylabs MCP integration

ai-toolsdata-collectione-comerce-scrapingllmllm-tools
Share:
95
Stars
0
Downloads
0
Weekly
0/5

What is Oxylabs?

Oxylabs is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to official oxylabs mcp integration

Official Oxylabs MCP integration

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Official Oxylabs MCP integration

Use Cases

E-commerce content scraping
Web data collection and extraction
oxylabs

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 9, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx oxylabs

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Oxylabs

The Oxylabs MCP Server is the official integration between Oxylabs' web scraping infrastructure and AI assistants via the Model Context Protocol. It exposes tools for universal web scraping, Google Search result extraction, Amazon product and search page scraping, plus AI-powered scraping via Oxylabs AI Studio — enabling AI agents to collect structured web data at scale without writing custom scrapers or handling proxy rotation manually.

Prerequisites

  • uv (Python package manager) installed — run: curl -LsSf https://astral.sh/uv/install.sh | sh
  • An Oxylabs Web Scraper API account (username and password) — 1-week free trial available at oxylabs.io
  • Optionally: an Oxylabs AI Studio API key for AI-powered scraping tools (1000 free credits)
  • An MCP client such as Claude Desktop, Cursor, or Cline
1

Install uv

Install uv, the Python package manager used to run the Oxylabs MCP server via uvx. This is the recommended installation method.

curl -LsSf https://astral.sh/uv/install.sh | sh
2

Obtain Oxylabs credentials

Sign up at oxylabs.io for a Web Scraper API account to get your username and password. Optionally, sign up for AI Studio to get an API key. Only supply credentials for the tools you intend to use.

3

Configure your MCP client

Open your MCP client config file and add the oxylabs server. Only include the environment variables for the services you have access to — unused credential variables will expose non-functional tools.

{
  "mcpServers": {
    "oxylabs": {
      "command": "uvx",
      "args": ["oxylabs-mcp"],
      "env": {
        "OXYLABS_USERNAME": "your_username",
        "OXYLABS_PASSWORD": "your_password"
      }
    }
  }
}
4

Add AI Studio key if available

If you also have an Oxylabs AI Studio key, add OXYLABS_AI_STUDIO_API_KEY to unlock the ai_scraper, ai_crawler, ai_browser_agent, and ai_search tools.

{
  "mcpServers": {
    "oxylabs": {
      "command": "uvx",
      "args": ["oxylabs-mcp"],
      "env": {
        "OXYLABS_USERNAME": "your_username",
        "OXYLABS_PASSWORD": "your_password",
        "OXYLABS_AI_STUDIO_API_KEY": "your_ai_studio_key"
      }
    }
  }
}
5

Restart your MCP client and verify

Restart Claude Desktop or your MCP client. Available tools will reflect the credentials you provided. Ask the AI to scrape a URL to confirm the integration is working.

Oxylabs Examples

Client configuration

Claude Desktop configuration for Oxylabs Web Scraper API tools using uvx.

{
  "mcpServers": {
    "oxylabs": {
      "command": "uvx",
      "args": ["oxylabs-mcp"],
      "env": {
        "OXYLABS_USERNAME": "your_username",
        "OXYLABS_PASSWORD": "your_password",
        "OXYLABS_AI_STUDIO_API_KEY": "your_ai_studio_key"
      }
    }
  }
}

Prompts to try

Ask your AI assistant to collect web data using Oxylabs scraping tools.

- "Scrape the product details from this Amazon listing: https://www.amazon.com/dp/B08N5WRWNW"
- "Search Amazon for 'wireless headphones' and return the top 10 results with prices"
- "Get the Google Search results for 'best MCP servers 2025' in the US locale"
- "Scrape the content from https://example.com and return it as clean markdown"
- "Use the AI scraper to extract all product names and prices from this e-commerce page"

Troubleshooting Oxylabs

uvx command not found

Install uv first: curl -LsSf https://astral.sh/uv/install.sh | sh, then restart your terminal. Confirm with: which uvx. If still missing, add ~/.local/bin to your PATH.

Tools appear in the client but requests fail with authentication errors

Double-check your OXYLABS_USERNAME and OXYLABS_PASSWORD. These are your Web Scraper API credentials, not your Oxylabs.io login email. You can verify them at app.oxylabs.io under API Access.

AI Studio tools are not available

AI Studio tools (ai_scraper, ai_crawler, ai_browser_agent, ai_search) only appear when OXYLABS_AI_STUDIO_API_KEY is set. Add this key to your env block. If you do not have an AI Studio account, sign up at oxylabs.io/products/ai-studio for free credits.

Frequently Asked Questions about Oxylabs

What is Oxylabs?

Oxylabs is a Model Context Protocol (MCP) server that official oxylabs mcp integration It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Oxylabs?

Follow the installation instructions on the Oxylabs GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Oxylabs?

Oxylabs works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Oxylabs free to use?

Yes, Oxylabs is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "oxylabs": { "command": "npx", "args": ["-y", "oxylabs"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Oxylabs?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides