Skip to content

io.oxylabs/oxylabs-mcp

by oxylabs.io · remote · local (pypi) · no sign-in to list tools · v0.9.1 · published by io.oxylabs

Fetch and process content from specified URLs & sources using the Oxylabs Web Scraper API.

Changes · 6

10 tools: 6 change things and 4 only read.

Scanned Oct 21, 2026

2 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http oxylabs https://mcp.oxylabs.io/mcp

Findings

Matches of fixed checks, with the text they matched.

2 warn
  • The server marks "ai_browser_agent" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The description's first verb is "run": a word for a change.

    What this check looks for
  • The server marks "generate_schema" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "generate_schema" says "generate": a word for a change.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

10 tools

Changes things 6Claude Code: ask
  • ai_browser_agentRun the browser agent and return the data in the specified format.1 finding

    Why it is in this group

    • The description's first verb is "run": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "ai_browser_agent" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The description's first verb is "run": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Run the browser agent and return the data in the specified format. This tool is useful if you need navigate around the website and do some actions. It allows navigating to any url, clicking on links, filling forms, scrolling, etc. Finally it returns the data in the specified format. Schema is required only if output_format is json, csv or toon. 'task_prompt' describes what browser agent should achieve

    Annotations the server declares

    • readOnlyHint: true
  • ai_crawlerTool useful for crawling a website from starting url and returning data in a specified format.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Tool useful for crawling a website from starting url and returning data in a specified format. Schema is required only if output_format is json, csv or toon. 'render_javascript' is used to render javascript heavy websites. 'return_sources_limit' is used to limit the number of sources to return, for example if you expect results from single source, you can set it to 1.

    Annotations the server declares

    • readOnlyHint: true
  • ai_mapTool useful for mapping website's URLs.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Tool useful for mapping website's URLs.

    Annotations the server declares

    • readOnlyHint: true
  • ai_scraperScrape the contents of the web page and return the data in the specified format.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Scrape the contents of the web page and return the data in the specified format. Schema is required only if output_format is json or csv. 'render_javascript' is used to render javascript heavy websites.

    Annotations the server declares

    • readOnlyHint: true
  • amazon_product_scraperScrape Amazon products.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Scrape Amazon products. Supports content parsing, different user agent types, domain, geolocation, locale parameters and different output formats. Supports Amazon specific parameters such as currency and getting more accurate pricing data with auto select variant.

    Annotations the server declares

    • readOnlyHint: true
  • generate_schemaGenerate a json schema in openapi format.1 finding

    Why it is in this group

    • The name "generate_schema" says "generate": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "generate_schema" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "generate_schema" says "generate": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Generate a json schema in openapi format.

    Annotations the server declares

    • readOnlyHint: true
Only reads 4Claude Code: allow
  • amazon_search_scraperScrape Amazon search results.No findings

    Why it is in this group

    • The name "amazon_search_scraper" says "search": a word for reading.
    Description, as the server wrote it
    Scrape Amazon search results. Supports content parsing, different user agent types, pagination, domain, geolocation, locale parameters and different output formats. Supports Amazon specific parameters such as category id, merchant id, currency.

    Annotations the server declares

    • readOnlyHint: true
  • google_search_scraperScrape Google Search results.No findings

    Why it is in this group

    • The name "google_search_scraper" says "search": a word for reading.
    Description, as the server wrote it
    Scrape Google Search results. Supports content parsing, different user agent types, pagination, domain, geolocation, locale parameters and different output formats.

    Annotations the server declares

    • readOnlyHint: true
  • universal_scraperGet a content of any webpage.No findings

    Why it is in this group

    • The description's first verb is "get": a word for reading.
    Description, as the server wrote it
    Get a content of any webpage. Supports browser rendering, parsing of certain webpages and different output formats.

    Annotations the server declares

    • readOnlyHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.9.1. Values in angle brackets are yours to fill in.

claude mcp add --transport http oxylabs https://mcp.oxylabs.io/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__oxylabs__ai_search",
      "mcp__oxylabs__universal_scraper",
      "mcp__oxylabs__google_search_scraper",
      "mcp__oxylabs__amazon_search_scraper"
    ],
    "ask": [
      "mcp__oxylabs__ai_crawler",
      "mcp__oxylabs__ai_scraper",
      "mcp__oxylabs__ai_browser_agent",
      "mcp__oxylabs__generate_schema",
      "mcp__oxylabs__ai_map",
      "mcp__oxylabs__amazon_product_scraper"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as oxylabs. Review it before you use it.