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-mcpgit clone https://github.com/oxylabs/web-api-mcp.gitpip 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 token
export 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
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.
Pricing
Open SourceMade by
No owner listed.
Sign in to claim this tool.