Oxylabs
Official Oxylabs MCP integration
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
Maintainer
Works with
Installation
Manual Installation
npx oxylabsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
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
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 | shObtain 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.
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"
}
}
}
}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"
}
}
}
}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.
Oxylabs Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Oxylabs? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译,支持 Google/DeepL/Ollama/OpenAI 等服务,提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
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.
Set Up Oxylabs in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
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.