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, manage CAPTCHA, and access geo-restricted web data from 195+ countries.
Note: clients that only support OAuth for remote servers (for example, adding a custom
connector in the claude.ai web UI) cannot pass headers yet — OAuth sign-in is on our roadmap.
Use the local setup below with those clients in the meantime.
Option 2: Run locally
Environment variables
Oxylabs MCP server supports the following environment variables:
Name
Description
Default
OXYLABS_API_TOKEN
Your Oxylabs Web Scraper API token
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
For the Web Scraper API tools, set either OXYLABS_API_TOKEN or both OXYLABS_USERNAME and
OXYLABS_PASSWORD. If both are set, the token is used. For the AI Studio tools, set
OXYLABS_AI_STUDIO_API_KEY.
All tools are always listed; calling a tool without the credentials it needs returns an error
message explaining what to configure.
❗ Important: only set the environment variables you have real credentials for.
Placeholder values make tool calls fail.
All tools are always listed regardless of provided credentials; calling a tool without the
credentials it needs returns an error message explaining exactly what to configure.
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.
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
The server provides additional information about the tool calls in notification/message events:
{
"method": "notifications/message",
"params": {
"level": "error",
"data": "Error: request to Oxylabs API failed"
}
}
✨ 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
Navigate sophisticated automated request management 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.
The Oxylabs MCP server makes that happen by doing the boring parts for you:
What Oxylabs MCP does
Why it matters to you
Manages automated request walls with the Oxylabs global proxy network
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.
Belum ada daftar tool. Server remote mendapatkannya setelah pemeriksaan kesehatan pertama.
FAQ
Pertanyaan
Bagaimana cara menginstal Oxylabs?
Salin konfigurasi http untuk Cursor, Claude Desktop, Claude Code, atau VS Code di halaman ini. Konfigurasi ini memakai instalasi dari penerbit, bukan proxy PlugMCP.
Apakah Oxylabs memerlukan kunci API?
Penerbit mencantumkan variabel lingkungan berikut: OXYLABS_API_TOKEN, OXYLABS_USERNAME, OXYLABS_PASSWORD, OXYLABS_AI_STUDIO_API_KEY.
Transport apa yang digunakan Oxylabs?
Oxylabs diakses melalui HTTP.
Kapan Oxylabs terakhir diperiksa?
Terakhir diperiksa 2026-11-11. Official Oxylabs MCP integration