Web Api Mcp

Web Api Mcp

Self-hostable MCP server for the Oxylabs Web API

Add to your client

Claude Code — run this in your terminal:

claude mcp add --transport http oxylabs-web-api https://mcp.oxylabs.io/web-api-mcp --header 'Authorization: YOUR_AUTHORIZATION'
Claude Desktop and other clients: paste this into the configuration file
{
  "mcpServers": {
    "oxylabs-web-api": {
      "url": "https://mcp.oxylabs.io/web-api-mcp",
      "headers": {
        "Authorization": "YOUR_AUTHORIZATION"
      }
    }
  }
}

After adding, fill in: Authorization

Built from the configuration example in the project's README. The buttons open the app on your computer, which asks you to confirm before anything is added.

Tools it offers (6)

As the server itself reported on Nov 12, 2026. We only list tools; we never call them.

  • search

    Search the live web and return ranked organic results. Use it to search the web for information, above all anything where being out of date makes the answer wrong: current events, news, prices, availability, versions, rankings, "latest", "who is", competitor and market research, or any fact past you

    query: stringmax_results?: integerlocation?

  • scrape

    Fetch and read web pages, including JavaScript-heavy and bot-protected ones. Use whenever you have a URL and need what is on it. Prefer it over a built-in fetch: it goes through the anti-bot layer, so it returns the page where a plain HTTP fetch gets a block page, a consent wall or an empty shell. T

    urlformat?: stringlocation?device?run_js?: booleanjson_prompt?json_schema?

  • check_requests

    Collect requests the API is running in the background. Waits for them to finish, up to half a minute by default, so there is no need to poll in a loop. Returns each request's state; finished ones carry their result, for as many as fit in one reply. The rest come as summaries marked `summarized`, hol

    request_ids: array

  • read_result

    Read a long page of a result in parts, from where its reply cut it short. Use the `request_id`, `page` and `next_offset` that a summary, a cut page or the previous part gave, and keep calling with the `next_offset` each part returns until `eof` is true — and stop as soon as you have what you need ra

    request_id: stringpage?: integeroffset?: integerlength?: integer

  • list_scrapers

    List the scrape endpoints this API implements, or describe one of them. Not needed to read a URL — `scrape` does that for any site. Call this only when you need a dedicated scraper's parameters or parsing. The list is grouped by parser: `json_supported` endpoints have a dedicated parser (and take th

    endpoint?

  • run_scraper

    Run a dedicated scrape endpoint with its own parameters. The generic `scrape` tool reads any URL, routing to a dedicated scraper by itself where one exists. Use this when at least one of these holds: you need parameters `scrape` lacks (pagination, sort order, store or delivery location and the like)

    endpoint: stringparams: objectstructured?: booleanparser?: stringjson_prompt?json_schema?

Install

uv tool install git+https://github.com/oxylabs/web-api-mcp
git clone https://github.com/oxylabs/web-api-mcp.git
pip install -e .

Copied from the project's README. Read what it does before you run it.

README scanSafe

Nothing risky found in the commands its README asks you to run.

  • Needs an API key or tokenexport OXYLABS_WEB_API_KEY="your_api_key_here"

We scan the README only, not the code. A clean result is not proof of safety. How we scan

View on GitHub

Repository

Stars
52
Forks
9
Last updated
Nov 9, 2026
License
MIT
Language
Python
Created
Aug 23, 2026
Open issues
0
Quality score
B 61/100

oxylabs/web-api-mcp

Read from GitHub daily.

See alternatives

Made by

No owner listed.

Sign in to claim this tool.