Oxylabs MCP Server

What is Oxylabs MCP Server?

The Oxylabs MCP Server bridges AI models and the web, enabling 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 over 195 countries.

How to use Oxylabs MCP Server?

Configure via uvx, uv, or Smithery by setting environment variables (OXYLABS_USERNAME, OXYLABS_PASSWORD, OXYLABS_AI_STUDIO_API_KEY). The server automatically exposes Web Scraper API tools, AI Studio tools, or both depending on which credentials are provided. Manual setup in Claude Desktop or Cursor AI is supported.

Key features of Oxylabs MCP Server

• Scrape any URL with full JavaScript rendering
• Convert HTML to clean Markdown or JSON
• Manage CAPTCHA and geo-restrictions automatically
• Built-in parsers for Google, Amazon, and more
• AI-powered scraping, crawling, and browser control
• Cross‑platform support (macOS, Windows, Linux)
• Comprehensive error handling and rate limiting

Use cases of Oxylabs MCP Server

• Extract AI‑ready data from dynamic JavaScript websites
• Perform automated Google or Amazon product searches
• Crawl a website and collect structured data based on a prompt
• Use an AI browser agent to visit sites and return screenshots or JSON
• Access geo‑restricted content from a proxy pool covering 195+ countries

FAQ from Oxylabs MCP Server

What credentials do I need to use the server?

You need at least one of: an Oxylabs Web Scraper API username/password or an Oxylabs AI Studio API key. The server exposes corresponding tools based on the credentials provided.

How do I configure the server?

Set the environment variables OXYLABS_USERNAME, OXYLABS_PASSWORD, and/or OXYLABS_AI_STUDIO_API_KEY in your MCP client config. If using Smithery, you can authenticate via OAuth2 or pass credentials as query parameters.

What runtime is required?

The server can be run via uvx (recommended) or uv on macOS, Windows, or Linux. No additional runtime beyond Python and the package manager is needed.

Where does scraped data live?

Data is retrieved from Oxylabs’ Web Scraper API or AI Studio APIs and returned directly to the LLM client. It is not stored or processed by the server itself after the response is sent.

Does the server handle CAPTCHAs and IP rotation automatically?

Yes, it uses Oxylabs’ global proxy network to manage automated request walls, CAPTCHAs, and IP rotation from a proxy pool covering 195+ countries.