[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_115":116},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@oxylabs/oxylabs-mcp' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92},"apiUrl","https://odel.app/api","creator","oxylabs","moduleId","oxylabs-mcp","@oxylabs/oxylabs-mcp","displayName","oxylabs mcp","tagline","Fetch and process content from specified URLs using the Oxylabs Web Scraper API.","iconKey","https://avatars.githubusercontent.com/u/43960873?v=4","category","data","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://server.smithery.ai/@oxylabs/oxylabs-mcp/mcp\",\"transport\":\"streamable-http\",\"authType\":\"bearer\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363218000,"updatedAt",1781499325000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=ai.smithery%2Foxylabs-oxylabs-mcp","sourceVerified",false,"importedAt","upstreamStars",97,"upstreamUpdatedAt",1780915420000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/oxylabs/oxylabs-mcp","githubRepoFullName","oxylabs/oxylabs-mcp","releaseId","ext-oxylabs-oxylabs-mcp","version","1.13.1","descriptionMarkdown","

\n $\"Oxylabs$ \n

\n Oxylabs MCP Server\n

\n\n

\n The missing link between AI models and the real‑world web: one API that delivers clean, structured data from any site.\n

\n\n

\n\n[![smithery badge](https://smithery.ai/badge/@oxylabs/oxylabs-mcp)](https://smithery.ai/server/@oxylabs/oxylabs-mcp)\n[![pypi package](https://img.shields.io/pypi/v/oxylabs-mcp?color=%2334D058&label=pypi%20package)](https://pypi.org/project/oxylabs-mcp/)\n[![](https://dcbadge.vercel.app/api/server/eWsVUJrnG5?style=flat)](https://discord.gg/Pds3gBmKMH)\n[![Licence](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/f6a9c0bc-83a6-4f78-89d9-f2cec4ece98d)\n![Coverage badge](https://raw.githubusercontent.com/oxylabs/oxylabs-mcp/coverage/coverage-badge.svg)\n\n
\n\n $\"Oxylabs$ \n\n\n

\n\n---\n\n## 📖 Overview\n\nThe 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.\n\n\n## 🛠️ MCP Tools\n\nOxylabs MCP provides two sets of tools that can be used together or independently:\n\n### Oxylabs Web Scraper API Tools\n1. **universal_scraper**: Uses Oxylabs Web Scraper API for general website scraping;\n2. **google_search_scraper**: Uses Oxylabs Web Scraper API to extract results from Google Search;\n3. **amazon_search_scraper**: Uses Oxylabs Web Scraper API to scrape Amazon search result pages;\n4. **amazon_product_scraper**: Uses Oxylabs Web Scraper API to extract data from individual Amazon product pages.\n\n### Oxylabs AI Studio Tools\n\n5. **ai_scraper**: Scrape content from any URL in JSON or Markdown format with AI-powered data extraction;\n6. **ai_crawler**: Based on a prompt, crawls a website and collects data in Markdown or JSON format across multiple pages;\n7. **ai_browser_agent**: Based on prompt, controls a browser and returns data in Markdown, JSON, HTML, or screenshot formats;\n8. **ai_search**: Search the web for URLs and their contents with AI-powered content extraction.\n\n\n## ✅ Prerequisites\n\nBefore you begin, make sure you have **at least one** of the following:\n\n- **Oxylabs Web Scraper API Account**: Obtain your username and password from [Oxylabs](https://dashboard.oxylabs.io/) (1-week free trial available);\n- **Oxylabs AI Studio API Key**: Obtain your API key from [Oxylabs AI Studio](https://aistudio.oxylabs.io/settings/api-key). (1000 credits free).\n\n## 📦 Configuration\n\n### Environment variables\n\nOxylabs MCP server supports the following environment variables:\n| Name | Description | Default |\n|----------------------------|-----------------------------------------------|---------|\n| `OXYLABS_USERNAME` | Your Oxylabs Web Scraper API username | |\n| `OXYLABS_PASSWORD` | Your Oxylabs Web Scraper API password | |\n| `OXYLABS_AI_STUDIO_API_KEY`| Your Oxylabs AI Studio API key | |\n| `LOG_LEVEL` | Log level for the logs returned to the client | `INFO` |\n\nBased on provided credentials, the server will automatically expose the corresponding tools:\n- If only `OXYLABS_USERNAME` and `OXYLABS_PASSWORD` are provided, the server will expose the Web Scraper API tools;\n- If only `OXYLABS_AI_STUDIO_API_KEY` is provided, the server will expose the AI Studio tools;\n- If both `OXYLABS_USERNAME` and `OXYLABS_PASSWORD` and `OXYLABS_AI_STUDIO_API_KEY` are provided, the server will expose all tools.\n\n❗❗❗ **Important note: if you don't have Web Scraper API or Oxylabs AI studio credentials, delete the corresponding environment variables placeholders.\nLeaving placeholder values will result in exposed tools that do not work.**\n\n\n\n### Configure with uvx\n\n- Install the uvx package manager:\n ```bash\n # macOS and Linux\n curl -LsSf https://astral.sh/uv/install.sh | sh\n ```\n OR:\n ```bash\n # Windows\n powershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n ```\n- Use the following config:\n ```json\n {\n \"mcpServers\": {\n \"oxylabs\": {\n \"command\": \"uvx\",\n \"args\": [\"oxylabs-mcp\"],\n \"env\": {\n \"OXYLABS_USERNAME\": \"OXYLABS_USERNAME\",\n \"OXYLABS_PASSWORD\": \"OXYLABS_PASSWORD\",\n \"OXYLABS_AI_STUDIO_API_KEY\": \"OXYLABS_AI_STUDIO_API_KEY\"\n }\n }\n }\n }\n ```\n\n### Configure with uv\n\n- Install the uv package manager:\n ```bash\n # macOS and Linux\n curl -LsSf https://astral.sh/uv/install.sh | sh\n ```\n OR:\n ```bash\n # Windows\n powershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n ```\n\n- Use the following config:\n ```json\n {\n \"mcpServers\": {\n \"oxylabs\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"//oxylabs-mcp\",\n \"run\",\n \"oxylabs-mcp\"\n ],\n \"env\": {\n \"OXYLABS_USERNAME\": \"OXYLABS_USERNAME\",\n \"OXYLABS_PASSWORD\": \"OXYLABS_PASSWORD\",\n \"OXYLABS_AI_STUDIO_API_KEY\": \"OXYLABS_AI_STUDIO_API_KEY\"\n }\n }\n }\n }\n ```\n\n### Configure with Smithery Oauth2\n\n- Go to https://smithery.ai/server/@oxylabs/oxylabs-mcp;\n- Click _Auto_ to install the Oxylabs MCP configuration for the respective client;\n- OR use the following config:\n```json\n {\n \"mcpServers\": {\n \"oxylabs\": {\n \"url\": \"https://server.smithery.ai/@oxylabs/oxylabs-mcp/mcp\"\n }\n }\n }\n```\n- Follow the instructions to authenticate Oxylabs MCP with Oauth2 flow\n\n### Configure with Smithery query parameters\n\nIn case your client does not support the Oauth2 authentication, you can pass the Oxylabs authentication parameters directly in url\n```json\n {\n \"mcpServers\": {\n \"oxylabs\": {\n \"url\": \"https://server.smithery.ai/@oxylabs/oxylabs-mcp/mcp?oxylabsUsername=OXYLABS_USERNAME&oxylabsPassword=OXYLABS_PASSWORD&oxylabsAiStudioApiKey=OXYLABS_AI_STUDIO_API_KEY\"\n }\n }\n }\n```\n\n### Manual Setup with Claude Desktop\n\nNavigate to **Claude → Settings → Developer → Edit Config** and add one of the configurations above to the `claude_desktop_config.json` file.\n\n### Manual Setup with Cursor AI\n\nNavigate to **Cursor → Settings → Cursor Settings → MCP**. Click **Add new global MCP server** and add one of the configurations above.\n\n\n\n## 📝 Logging\n\nServer provides additional information about the tool calls in `notification/message` events\n\n```json\n{\n \"method\": \"notifications/message\",\n \"params\": {\n \"level\": \"info\",\n \"data\": \"Create job with params: {\\\"url\\\": \\\"https://ip.oxylabs.io\\\"}\"\n }\n}\n```\n\n```json\n{\n \"method\": \"notifications/message\",\n \"params\": {\n \"level\": \"info\",\n \"data\": \"Job info: job_id=7333113830223918081 job_status=done\"\n }\n}\n```\n\n```json\n{\n \"method\": \"notifications/message\",\n \"params\": {\n \"level\": \"error\",\n \"data\": \"Error: request to Oxylabs API failed\"\n }\n}\n```\n\n---\n\n## 🛡️ License\n\nDistributed under the MIT License – see [LICENSE](https://github.com/oxylabs/oxylabs-mcp/blob/main/LICENSE) for details.\n\n---\n\n## About Oxylabs\n\nEstablished in 2015, Oxylabs is a market-leading web intelligence collection\nplatform, driven by the highest business, ethics, and compliance standards,\nenabling companies worldwide to unlock data-driven insights.\n\n[![image](https://oxylabs.io/images/og-image.png)](https://oxylabs.io/)\n\n

\n_{\n Made with ☕ by Oxylabs. Feel free to give us a ⭐ if MCP saved you a weekend.\n}\n

\n\n\n## ✨ Key Features\n\n

Scrape content from any site

\n
\n\n- Extract data from any URL, including complex single-page applications\n- Fully render dynamic websites using headless browser support\n- Choose full JavaScript rendering, HTML-only, or none\n- Emulate Mobile and Desktop viewports for realistic rendering\n\n

\n\n

Automatically get AI-ready data

\n
\n\n- Automatically clean and convert HTML to Markdown for improved readability\n- Use automated parsers for popular targets like Google, Amazon, and more\n\n

\n\n

Manage CAPTCHA & geo-restrictions

\n
\n\n- Navigate sophisticated automated request management systems with high success rate\n- Reliably scrape even the most complex websites\n- Get automatically rotating IPs from a proxy pool covering 195+ countries\n\n

\n\n

Flexible setup & cross-platform support

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

\n\n

Built-in error handling and request management

\n
\n\n- Comprehensive error handling and reporting\n- Smart rate limiting and request management\n\n

\n\n---\n\n\n## Why Oxylabs MCP? 🕸️ ➜ 📦 ➜ 🤖\n\nImagine telling your LLM *\"Summarise the latest Hacker News discussion about GPT‑5\"* – and it simply answers. \nMCP (Multi‑Client Proxy) makes that happen by doing the boring parts for you:\n\n| What Oxylabs MCP does | Why it matters to you |\n|-------------------------------------------------------------------|------------------------------------------|\n| **Manage automated requests walls** with the Oxylabs global proxy network | Enables website access and anonymity |\n| **Renders JavaScript** in headless Chrome | Single‑page apps, sorted |\n| **Cleans HTML → JSON** | Drop straight into vector DBs or prompts |\n| **Optional structured parsers** (Google, Amazon, etc.) | One‑line access to popular targets |\n\nmcp-name: io.oxylabs/oxylabs-mcp\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Data & Analytics","upstream",{"_95":96,"_97":98,"_99":100,"_101":102,"_103":104},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","topics",[105,106,107,108,109,110,111,112,19,113,114],"license","MIT","language","Python","registryName","ai.smithery/oxylabs-oxylabs-mcp","homepage","https://oxylabs.io","ai-tools","data-collection","e-comerce-scraping","llm","llm-tools","mcp","mcp-server","model-context-protocol","python","scraping","ENV",{"_117":118,"_119":120,"_121":122},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]