oxylabs-web-api-mcp 0.3.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- oxylabs_web_api_mcp-0.3.0/.env.example +33 -0
- oxylabs_web_api_mcp-0.3.0/.github/workflows/lint_and_test.yml +41 -0
- oxylabs_web_api_mcp-0.3.0/.github/workflows/publish.yml +51 -0
- oxylabs_web_api_mcp-0.3.0/.github/workflows/skill_sync.yml +37 -0
- oxylabs_web_api_mcp-0.3.0/.gitignore +16 -0
- oxylabs_web_api_mcp-0.3.0/Dockerfile +18 -0
- oxylabs_web_api_mcp-0.3.0/LICENSE +21 -0
- oxylabs_web_api_mcp-0.3.0/PKG-INFO +12 -0
- oxylabs_web_api_mcp-0.3.0/README.md +305 -0
- oxylabs_web_api_mcp-0.3.0/pyproject.toml +44 -0
- oxylabs_web_api_mcp-0.3.0/scripts/sync-skill.sh +34 -0
- oxylabs_web_api_mcp-0.3.0/server.json +27 -0
- oxylabs_web_api_mcp-0.3.0/src/oxylabs_web_api_mcp/__init__.py +1 -0
- oxylabs_web_api_mcp-0.3.0/src/oxylabs_web_api_mcp/app.py +49 -0
- oxylabs_web_api_mcp-0.3.0/src/oxylabs_web_api_mcp/client.py +430 -0
- oxylabs_web_api_mcp-0.3.0/src/oxylabs_web_api_mcp/companies.py +228 -0
- oxylabs_web_api_mcp-0.3.0/src/oxylabs_web_api_mcp/config.py +137 -0
- oxylabs_web_api_mcp-0.3.0/src/oxylabs_web_api_mcp/content.py +547 -0
- oxylabs_web_api_mcp-0.3.0/src/oxylabs_web_api_mcp/errors.py +36 -0
- oxylabs_web_api_mcp-0.3.0/src/oxylabs_web_api_mcp/results.py +563 -0
- oxylabs_web_api_mcp-0.3.0/src/oxylabs_web_api_mcp/scraping.py +355 -0
- oxylabs_web_api_mcp-0.3.0/src/oxylabs_web_api_mcp/server.py +69 -0
- oxylabs_web_api_mcp-0.3.0/src/oxylabs_web_api_mcp/skill.py +56 -0
- oxylabs_web_api_mcp-0.3.0/src/oxylabs_web_api_mcp/skills/oxylabs-web-api.md +432 -0
- oxylabs_web_api_mcp-0.3.0/src/oxylabs_web_api_mcp/tools.py +615 -0
- oxylabs_web_api_mcp-0.3.0/tests/conftest.py +12 -0
- oxylabs_web_api_mcp-0.3.0/tests/helpers.py +131 -0
- oxylabs_web_api_mcp-0.3.0/tests/test_client.py +566 -0
- oxylabs_web_api_mcp-0.3.0/tests/test_companies.py +269 -0
- oxylabs_web_api_mcp-0.3.0/tests/test_config.py +46 -0
- oxylabs_web_api_mcp-0.3.0/tests/test_content.py +379 -0
- oxylabs_web_api_mcp-0.3.0/tests/test_scraping.py +538 -0
- oxylabs_web_api_mcp-0.3.0/tests/test_server.py +22 -0
- oxylabs_web_api_mcp-0.3.0/tests/test_tools.py +976 -0
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Oxylabs Web API credentials
|
|
2
|
+
OXYLABS_WEB_API_KEY=your_api_key_here
|
|
3
|
+
|
|
4
|
+
# Optional overrides
|
|
5
|
+
OXYLABS_BASE_URL=https://webapi.oxylabs.io
|
|
6
|
+
|
|
7
|
+
# Large pages: offload to disk (stdio) or truncate (http) above this many tokens per reply.
|
|
8
|
+
# Tokens, not characters — 40k chars of English is ~10k tokens but 40k chars of Chinese
|
|
9
|
+
# is ~40k, and clients reject a tool result over 25k. A client can override per request
|
|
10
|
+
# with an X-MCP-Max-Tokens header; 0 opts out.
|
|
11
|
+
OXYLABS_MAX_INLINE_TOKENS=10000
|
|
12
|
+
# Where offloaded pages go (stdio only). Defaults to a per-user directory in the system
|
|
13
|
+
# temp dir; if you set one, use a directory you own.
|
|
14
|
+
# OXYLABS_SPILL_DIR=
|
|
15
|
+
# Set to 0 to keep everything inline even on stdio
|
|
16
|
+
OXYLABS_SPILL=1
|
|
17
|
+
|
|
18
|
+
# Retry transient failures (429/500/502/503/504) before giving up
|
|
19
|
+
OXYLABS_RETRIES=2
|
|
20
|
+
|
|
21
|
+
# Cap what each API key spends through this server, e.g. 100/1h or 50/30m. Unset = no limit.
|
|
22
|
+
OXYLABS_RATE_LIMIT=
|
|
23
|
+
|
|
24
|
+
# HTTP transport (self-hosting). A .env file cannot set these: only OXYLABS_* names are
|
|
25
|
+
# read from it. Set them in the real environment or with docker --env-file;
|
|
26
|
+
# MCP_TRANSPORT, HOST and PORT can also be passed as --transport, --host and --port.
|
|
27
|
+
# MCP_TRANSPORT=stdio
|
|
28
|
+
# HOST=127.0.0.1
|
|
29
|
+
# PORT=8080
|
|
30
|
+
# Hostnames this server answers for. Required over HTTP: anything else gets a 421.
|
|
31
|
+
# MCP_ALLOWED_HOSTS=localhost:*,127.0.0.1:*
|
|
32
|
+
# Origin allowlist for browser clients. Unset leaves FastMCP's same-origin default.
|
|
33
|
+
# MCP_ALLOWED_ORIGINS=
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
name: Lint & Test
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
branches: [ main ]
|
|
6
|
+
pull_request:
|
|
7
|
+
branches: [ main ]
|
|
8
|
+
|
|
9
|
+
jobs:
|
|
10
|
+
lint_and_test:
|
|
11
|
+
runs-on: ubuntu-latest
|
|
12
|
+
strategy:
|
|
13
|
+
matrix:
|
|
14
|
+
python-version: [ "3.10", "3.12", "3.13", "3.14" ]
|
|
15
|
+
steps:
|
|
16
|
+
- uses: actions/checkout@v4
|
|
17
|
+
- uses: actions/setup-python@v5
|
|
18
|
+
with:
|
|
19
|
+
python-version: ${{ matrix.python-version }}
|
|
20
|
+
- name: Install
|
|
21
|
+
run: pip install -e '.[dev]'
|
|
22
|
+
- name: Lint
|
|
23
|
+
run: |
|
|
24
|
+
ruff check .
|
|
25
|
+
ruff format --check .
|
|
26
|
+
- name: Test
|
|
27
|
+
run: pytest -q
|
|
28
|
+
|
|
29
|
+
lowest_dependencies:
|
|
30
|
+
runs-on: ubuntu-latest
|
|
31
|
+
steps:
|
|
32
|
+
- uses: actions/checkout@v4
|
|
33
|
+
- uses: actions/setup-python@v5
|
|
34
|
+
with:
|
|
35
|
+
python-version: "3.10"
|
|
36
|
+
- name: Install the lowest allowed versions
|
|
37
|
+
run: |
|
|
38
|
+
pip install uv
|
|
39
|
+
uv pip install --system --resolution lowest-direct -r pyproject.toml --extra dev
|
|
40
|
+
- name: Test
|
|
41
|
+
run: pytest -q
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
name: Publish to PyPI
|
|
2
|
+
|
|
3
|
+
# Runs on a version tag (v0.1.0). Uses PyPI trusted publishing (OIDC) — no token
|
|
4
|
+
# secret; PyPI must have this repo + workflow configured as a trusted publisher
|
|
5
|
+
# for the oxylabs-web-api-mcp project, environment "pypi".
|
|
6
|
+
|
|
7
|
+
on:
|
|
8
|
+
push:
|
|
9
|
+
tags: [ "v*" ]
|
|
10
|
+
|
|
11
|
+
jobs:
|
|
12
|
+
test:
|
|
13
|
+
runs-on: ubuntu-latest
|
|
14
|
+
steps:
|
|
15
|
+
- uses: actions/checkout@v4
|
|
16
|
+
- uses: actions/setup-python@v5
|
|
17
|
+
with:
|
|
18
|
+
python-version: "3.12"
|
|
19
|
+
- run: pip install -e '.[dev]'
|
|
20
|
+
- run: |
|
|
21
|
+
ruff check .
|
|
22
|
+
ruff format --check .
|
|
23
|
+
- run: pytest -q
|
|
24
|
+
|
|
25
|
+
publish:
|
|
26
|
+
needs: test
|
|
27
|
+
runs-on: ubuntu-latest
|
|
28
|
+
environment: pypi
|
|
29
|
+
permissions:
|
|
30
|
+
id-token: write
|
|
31
|
+
steps:
|
|
32
|
+
- uses: actions/checkout@v4
|
|
33
|
+
- name: Check the tag and server.json match the project version
|
|
34
|
+
run: |
|
|
35
|
+
version=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
|
|
36
|
+
[ "v$version" = "${GITHUB_REF_NAME}" ] || { echo "tag ${GITHUB_REF_NAME} != pyproject version $version"; exit 1; }
|
|
37
|
+
python - "$version" <<'EOF'
|
|
38
|
+
import json, sys
|
|
39
|
+
version = sys.argv[1]
|
|
40
|
+
manifest = json.load(open("server.json"))
|
|
41
|
+
found = {"version": manifest["version"]}
|
|
42
|
+
found.update({f"packages[{i}].version": p["version"] for i, p in enumerate(manifest["packages"])})
|
|
43
|
+
wrong = {k: v for k, v in found.items() if v != version}
|
|
44
|
+
if wrong:
|
|
45
|
+
sys.exit(f"server.json does not match pyproject version {version}: {wrong}")
|
|
46
|
+
EOF
|
|
47
|
+
- uses: actions/setup-python@v5
|
|
48
|
+
with:
|
|
49
|
+
python-version: "3.12"
|
|
50
|
+
- run: pip install build && python -m build
|
|
51
|
+
- uses: pypa/gh-action-pypi-publish@release/v1
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
name: Sync skill
|
|
2
|
+
|
|
3
|
+
# The bundled skill is a copy of web-api-skills' SKILL.md (the canonical one). Daily, copy
|
|
4
|
+
# it over the bundled one and, if that changes anything, open or update a PR with the change.
|
|
5
|
+
# Nothing blocks other PRs; the sync PR handles the drift on its own.
|
|
6
|
+
# Relies on the repo setting that lets GitHub Actions create pull requests (enabled).
|
|
7
|
+
|
|
8
|
+
on:
|
|
9
|
+
schedule:
|
|
10
|
+
- cron: "0 6 * * *"
|
|
11
|
+
workflow_dispatch:
|
|
12
|
+
|
|
13
|
+
permissions:
|
|
14
|
+
contents: write
|
|
15
|
+
pull-requests: write
|
|
16
|
+
|
|
17
|
+
jobs:
|
|
18
|
+
sync:
|
|
19
|
+
runs-on: ubuntu-latest
|
|
20
|
+
steps:
|
|
21
|
+
- uses: actions/checkout@v4
|
|
22
|
+
- name: Copy the skill from web-api-skills main
|
|
23
|
+
run: ./scripts/sync-skill.sh https://raw.githubusercontent.com/oxylabs/web-api-skills/main/skills/oxylabs-web-api/SKILL.md
|
|
24
|
+
- name: Open or update the sync PR
|
|
25
|
+
uses: peter-evans/create-pull-request@v7
|
|
26
|
+
with:
|
|
27
|
+
branch: bot/sync-skill
|
|
28
|
+
delete-branch: true
|
|
29
|
+
commit-message: Sync the bundled skill from web-api-skills
|
|
30
|
+
title: Sync the bundled skill from web-api-skills
|
|
31
|
+
body: |
|
|
32
|
+
The bundled skill differs from `skills/oxylabs-web-api/SKILL.md` on
|
|
33
|
+
[web-api-skills](https://github.com/oxylabs/web-api-skills) `main`, so this PR copies it over
|
|
34
|
+
(`scripts/sync-skill.sh`). Opened by the daily `Sync skill` workflow.
|
|
35
|
+
|
|
36
|
+
If this undoes an edit made to the bundled copy here, move that edit to web-api-skills instead —
|
|
37
|
+
that is the copy the plugin and other agents install.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
.DS_Store
|
|
2
|
+
__pycache__/
|
|
3
|
+
*.py[cod]
|
|
4
|
+
.idea/
|
|
5
|
+
.venv/
|
|
6
|
+
venv/
|
|
7
|
+
.env
|
|
8
|
+
dist/
|
|
9
|
+
build/
|
|
10
|
+
*.egg-info/
|
|
11
|
+
.pytest_cache/
|
|
12
|
+
.ruff_cache/
|
|
13
|
+
# Nothing consumes this: CI and the Dockerfile both install with pip, and CI resolves
|
|
14
|
+
# fresh against three Python versions on purpose so upstream breakage shows up there.
|
|
15
|
+
# A tracked lock nobody validates only rots.
|
|
16
|
+
uv.lock
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
FROM python:3.12-slim
|
|
2
|
+
|
|
3
|
+
WORKDIR /app
|
|
4
|
+
COPY pyproject.toml README.md ./
|
|
5
|
+
COPY src ./src
|
|
6
|
+
RUN pip install --no-cache-dir . \
|
|
7
|
+
&& useradd --system --uid 10001 --no-create-home --shell /usr/sbin/nologin mcp
|
|
8
|
+
|
|
9
|
+
# Nothing here needs root; a numeric user also satisfies runAsNonRoot checks.
|
|
10
|
+
USER 10001
|
|
11
|
+
|
|
12
|
+
ENV MCP_TRANSPORT=http \
|
|
13
|
+
HOST=0.0.0.0 \
|
|
14
|
+
PORT=8080
|
|
15
|
+
EXPOSE 8080
|
|
16
|
+
|
|
17
|
+
# OXYLABS_WEB_API_KEY must be supplied at runtime, never baked into the image.
|
|
18
|
+
CMD ["oxylabs-web-api-mcp"]
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Oxylabs
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: oxylabs-web-api-mcp
|
|
3
|
+
Version: 0.3.0
|
|
4
|
+
Summary: Self-hostable MCP server for the Oxylabs Web API (/v1/search, /v1/search/companies, /v1/scrape)
|
|
5
|
+
License-File: LICENSE
|
|
6
|
+
Requires-Python: >=3.10
|
|
7
|
+
Requires-Dist: fastmcp<5,>=3.4.3
|
|
8
|
+
Requires-Dist: httpx<1,>=0.28.1
|
|
9
|
+
Requires-Dist: mcp<3,>=1.24
|
|
10
|
+
Provides-Extra: dev
|
|
11
|
+
Requires-Dist: pytest>=8; extra == 'dev'
|
|
12
|
+
Requires-Dist: ruff>=0.15; extra == 'dev'
|
|
@@ -0,0 +1,305 @@
|
|
|
1
|
+
# Oxylabs Web API — MCP Server
|
|
2
|
+
|
|
3
|
+
mcp-name: io.oxylabs/web-api-mcp
|
|
4
|
+
|
|
5
|
+
This repository is a developer-focused, technical reference covering the official [Model Context Protocol](https://modelcontextprotocol.io) server for the Oxylabs Web API. It gives any MCP-capable agent live web access – search, scrape pages as Markdown or JSON, and call dedicated scrapers – through one MCP connection.
|
|
6
|
+
|
|
7
|
+
| | Remote MCP | Self-hosted MCP |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| **Runs on** | Oxylabs infrastructure | Your machine or infrastructure |
|
|
10
|
+
| **Setup** | Add the server URL and your API key to your client | Install the server (Python 3.10+ and `uv`), then configure your client |
|
|
11
|
+
| **Updates and maintenance** | Managed by Oxylabs | Managed by you |
|
|
12
|
+
| **Best for** | The quickest way to give a compatible agent access to Web API | Full control over the environment, or clients that can't connect to remote servers with a custom header |
|
|
13
|
+
|
|
14
|
+
The tools and their behavior are the same on both options, and the sections on self-hosting cover everything you need to run the server yourself.
|
|
15
|
+
|
|
16
|
+
| Tool | What it does |
|
|
17
|
+
|---|---|
|
|
18
|
+
| `search` | Search the live web, returns ranked organic results (title, outline snippets, URL) |
|
|
19
|
+
| `search_companies` | Search companies by name or free-text description, returns company profiles best match first (industry, size, headquarters, funding, revenue, web traffic) |
|
|
20
|
+
| `scrape` | Read a URL, or a list of URLs, as **Markdown** by default, including JS-heavy and bot-protected pages. Ask for a screenshot, or pass `json_prompt` / `json_schema` to pull named fields off the page as JSON |
|
|
21
|
+
| `list_scrapers` | List the scrape endpoints the API implements, grouped by parser support, or describe one's parameters |
|
|
22
|
+
| `run_scraper` | Run a dedicated scrape endpoint with its own parameters, as content or as structured JSON; a list of `url`s or `query`s runs them all |
|
|
23
|
+
| `check_requests` | Collect requests the API is running in the background, waiting for them to finish |
|
|
24
|
+
| `read_result` | Read a page, or a `search_companies` list, too long for one reply in parts, by its request id |
|
|
25
|
+
|
|
26
|
+
All seven are annotated `readOnlyHint` — nothing here writes anything, so clients can run
|
|
27
|
+
them without prompting.
|
|
28
|
+
|
|
29
|
+
## Requirements
|
|
30
|
+
|
|
31
|
+
- **An Oxylabs Web API key** — in the [Oxylabs dashboard](https://dashboard.oxylabs.io), create a **Web API** instance, open it, and copy the API key shown at the top of the instance page.
|
|
32
|
+
- **For Remote MCP** – an MCP client that supports remote (HTTP) MCP servers with custom headers, such as Claude Code, Codex, or Cursor.
|
|
33
|
+
- **For self-hosting** – Python 3.10+ (built on [FastMCP](https://gofastmcp.com), installed with the package) and [`uv`](https://docs.astral.sh/uv/getting-started/installation/).
|
|
34
|
+
|
|
35
|
+
## Connect to the Remote MCP server
|
|
36
|
+
|
|
37
|
+
The server is hosted and maintained by Oxylabs. There is nothing to install or update.
|
|
38
|
+
|
|
39
|
+
```
|
|
40
|
+
https://mcp.oxylabs.io/web-api-mcp
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
The server authenticates each request with your Web API key, sent as an `Authorization: Bearer <key>` header. Set the key as an environment variable in the terminal where you run your client:
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
export OXYLABS_WEB_API_KEY="your_api_key_here"
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Claude Code:
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
claude mcp add --transport http --scope user oxylabs-web-api \
|
|
53
|
+
https://mcp.oxylabs.io/web-api-mcp \
|
|
54
|
+
--header "Authorization: Bearer ${OXYLABS_WEB_API_KEY}"
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Codex:
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
codex mcp add oxylabs-web-api \
|
|
61
|
+
--url https://mcp.oxylabs.io/web-api-mcp \
|
|
62
|
+
--bearer-token-env-var OXYLABS_WEB_API_KEY
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Cursor — one click, then make the key visible to Cursor (below):
|
|
66
|
+
|
|
67
|
+
[](https://cursor.com/en/install-mcp?name=oxylabs-web-api&config=eyJ1cmwiOiJodHRwczovL21jcC5veHlsYWJzLmlvL3dlYi1hcGktbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7ZW52Ok9YWUxBQlNfV0VCX0FQSV9LRVl9In19)
|
|
68
|
+
|
|
69
|
+
Cursor reads `${env:OXYLABS_WEB_API_KEY}` from its own environment. On macOS, Cursor opened from the Dock or Spotlight does not see variables exported in your shell profile, so either start it from a terminal where the key is exported, or replace `${env:OXYLABS_WEB_API_KEY}` with the key itself in **Cursor Settings → Tools & MCP** (or in `~/.cursor/mcp.json`). If Cursor can't see the variable, it sends an empty key: the server still connects and lists its tools, but every call fails with an error saying the Web API key is missing.
|
|
70
|
+
|
|
71
|
+
Cursor (manual, `~/.cursor/mcp.json`) and other clients supporting custom headers:
|
|
72
|
+
|
|
73
|
+
```json
|
|
74
|
+
{
|
|
75
|
+
"mcpServers": {
|
|
76
|
+
"oxylabs-web-api": {
|
|
77
|
+
"url": "https://mcp.oxylabs.io/web-api-mcp",
|
|
78
|
+
"headers": {
|
|
79
|
+
"Authorization": "Bearer ${env:OXYLABS_WEB_API_KEY}"
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
Clients that only support OAuth sign-in for remote servers, such as custom connectors in the claude.ai web interface, can't send custom headers and can't connect to the Remote MCP server — use the self-hosted server with those clients instead.
|
|
87
|
+
|
|
88
|
+
## Self-hosting
|
|
89
|
+
|
|
90
|
+
Run the server yourself when you want full control over where it runs and how it is configured. You install, host, and update it. The Remote MCP server and a self-hosted server use the same server name (`oxylabs-web-api`) in the examples, so if you switch from one to the other, remove the existing server from your client first.
|
|
91
|
+
|
|
92
|
+
### Install
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
uv tool install git+https://github.com/oxylabs/web-api-mcp
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
That puts `oxylabs-web-api-mcp` on your `PATH` in its own environment. `pipx install git+https://github.com/oxylabs/web-api-mcp` does the same. Installing into a system Python usually fails — most are marked externally managed and refuse. To work on the server itself:
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
git clone https://github.com/oxylabs/web-api-mcp.git
|
|
102
|
+
cd web-api-mcp
|
|
103
|
+
pip install -e .
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
`server.json` is the [MCP registry](https://github.com/modelcontextprotocol/registry) manifest for the PyPI package `oxylabs-web-api-mcp`. The publish workflow refuses a release whose `server.json` versions differ from `pyproject.toml`, so bump them together.
|
|
107
|
+
|
|
108
|
+
### Run it locally (stdio)
|
|
109
|
+
|
|
110
|
+
Point your client at the installed `oxylabs-web-api-mcp` command. Keep your API key in an environment variable or a `.env` file rather than writing it into a client config.
|
|
111
|
+
|
|
112
|
+
Claude Code:
|
|
113
|
+
|
|
114
|
+
```bash
|
|
115
|
+
claude mcp add oxylabs-web-api \
|
|
116
|
+
--env OXYLABS_WEB_API_KEY='${OXYLABS_WEB_API_KEY}' \
|
|
117
|
+
-- oxylabs-web-api-mcp
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
Claude Desktop — create a `.env` file containing `OXYLABS_WEB_API_KEY=your_api_key_here`, keep it outside any shared or version-controlled folder, and point the server at it:
|
|
121
|
+
|
|
122
|
+
```json
|
|
123
|
+
{
|
|
124
|
+
"mcpServers": {
|
|
125
|
+
"oxylabs-web-api": {
|
|
126
|
+
"command": "oxylabs-web-api-mcp",
|
|
127
|
+
"env": { "OXYLABS_ENV_FILE": "/absolute/path/to/.env" }
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
Cursor:
|
|
134
|
+
|
|
135
|
+
```json
|
|
136
|
+
{
|
|
137
|
+
"mcpServers": {
|
|
138
|
+
"oxylabs-web-api": {
|
|
139
|
+
"command": "oxylabs-web-api-mcp",
|
|
140
|
+
"env": { "OXYLABS_WEB_API_KEY": "${env:OXYLABS_WEB_API_KEY}" }
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
For other clients that read a JSON config, use the same `command` entry and your client's
|
|
147
|
+
own way of passing environment variables.
|
|
148
|
+
|
|
149
|
+
### Run it as a shared server (HTTP)
|
|
150
|
+
|
|
151
|
+
The HTTP transport is for running one shared server for a team or for agents that
|
|
152
|
+
can't spawn local processes.
|
|
153
|
+
|
|
154
|
+
```bash
|
|
155
|
+
export OXYLABS_WEB_API_KEY=your_api_key_here
|
|
156
|
+
export MCP_ALLOWED_HOSTS='mcp.internal.example.com,localhost:*'
|
|
157
|
+
oxylabs-web-api-mcp --transport http --host 0.0.0.0 --port 8080
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
The endpoint is then `http://<host>:8080/mcp`.
|
|
161
|
+
|
|
162
|
+
#### Docker
|
|
163
|
+
|
|
164
|
+
```bash
|
|
165
|
+
export OXYLABS_WEB_API_KEY=your_api_key_here
|
|
166
|
+
docker build -t oxylabs-web-api-mcp .
|
|
167
|
+
docker run --rm -p 8080:8080 \
|
|
168
|
+
-e OXYLABS_WEB_API_KEY \
|
|
169
|
+
-e MCP_ALLOWED_HOSTS='localhost:*,mcp.internal.example.com' \
|
|
170
|
+
oxylabs-web-api-mcp
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
Passing `-e OXYLABS_WEB_API_KEY` with no value makes Docker take the variable from your shell.
|
|
174
|
+
|
|
175
|
+
> **`MCP_ALLOWED_HOSTS` is not optional.** The HTTP transport turns on DNS-rebinding
|
|
176
|
+
> protection, so a server that doesn't declare its own hostname rejects every request
|
|
177
|
+
> with a `Host` header it doesn't recognise (`421 Misdirected Request`). List the
|
|
178
|
+
> hostname clients actually connect to. `host:*` matches any port on that host.
|
|
179
|
+
|
|
180
|
+
### Configuration
|
|
181
|
+
|
|
182
|
+
These variables apply to a server you run yourself. The Remote MCP server's settings are managed by Oxylabs.
|
|
183
|
+
|
|
184
|
+
| Variable | Default | Purpose |
|
|
185
|
+
|---|---|---|
|
|
186
|
+
| `OXYLABS_WEB_API_KEY` | *(required on stdio)* | Web API key, sent as `Authorization: Bearer <key>`. Over HTTP a per-request `Authorization: Bearer` header takes precedence |
|
|
187
|
+
| `OXYLABS_BASE_URL` | `https://webapi.oxylabs.io` | Override the API base URL, e.g. to go through a proxy |
|
|
188
|
+
| `OXYLABS_RETRIES` | `2` | Retries on transient errors |
|
|
189
|
+
| `OXYLABS_RATE_LIMIT` | *(off)* | Cap what each API key spends through this server, e.g. `100/1h`, `50/30m`. Each item of a batch counts as one scrape |
|
|
190
|
+
| `OXYLABS_MAX_INLINE_TOKENS` | `10000` | Token budget for one reply; content beyond it is offloaded (stdio) or truncated (HTTP); company lists are shrunk and trimmed |
|
|
191
|
+
| `OXYLABS_SPILL_DIR` | a per-user directory in the system temp dir | Where offloaded pages, company lists and screenshots are written (stdio only). Must be a directory you own |
|
|
192
|
+
| `OXYLABS_SPILL` | `1` | Set to `0` to keep everything inline even on stdio |
|
|
193
|
+
| `MCP_TRANSPORT` | `stdio` | `stdio` or `http` |
|
|
194
|
+
| `HOST` / `PORT` | `127.0.0.1` / `8080` | HTTP transport bind address |
|
|
195
|
+
| `MCP_ALLOWED_HOSTS` | `localhost:*,127.0.0.1:*` | Comma-separated `Host` allowlist (HTTP only) |
|
|
196
|
+
| `MCP_ALLOWED_ORIGINS` | *(empty)* | Comma-separated `Origin` allowlist (browser clients) |
|
|
197
|
+
|
|
198
|
+
Copy `.env.example` to `.env` for local use. On stdio the server reads that `.env` from its working directory: any `OXYLABS_*` name not already set in the environment is filled from there, so a project that keeps its key in `.env` needs no launcher wrapper. Real environment variables always win, and only `OXYLABS_*` names are read. Point it elsewhere with `OXYLABS_ENV_FILE=/path/to/.env`.
|
|
199
|
+
|
|
200
|
+
The key is read at request time and is never written to disk or logged.
|
|
201
|
+
|
|
202
|
+
## The skill ships with the server
|
|
203
|
+
|
|
204
|
+
Connecting the server is the whole install. The agent skill is bundled in the package and served as an MCP resource and a prompt, so a client that never adds the [web-api-skills](https://github.com/oxylabs/web-api-skills) repo still gets the judgment for using these tools well — search to find and scrape to read, when JavaScript rendering earns its cost, what to do with an empty page, how to cite.
|
|
205
|
+
|
|
206
|
+
| | |
|
|
207
|
+
|---|---|
|
|
208
|
+
| `oxylabs://skill/web-api` | The skill itself, as Markdown |
|
|
209
|
+
| prompt `web_research` | Takes a `question`, hands the agent the task plus the skill |
|
|
210
|
+
|
|
211
|
+
`scripts/sync-skill.sh` refreshes the bundled copy from the skills repo — the canonical copy lives there, and the two must not drift. Edit the skill in web-api-skills, never here: a daily workflow copies web-api-skills `main` over the bundled copy and opens a PR when that changes anything.
|
|
212
|
+
|
|
213
|
+
## Fitting the client's context
|
|
214
|
+
|
|
215
|
+
Oversized content is measured in **tokens, not characters**: 40 000 characters of English is about 10 000 tokens, but 40 000 characters of Chinese is about 40 000, and Claude Code, Claude Desktop and Cursor all reject a tool result over 25 000. The estimate is script-aware for that reason. The budget is `OXYLABS_MAX_INLINE_TOKENS` (default 10 000), and a client that knows its own limit can override it per request with an `X-MCP-Max-Tokens` header — `0` opts out entirely. The budget covers the whole reply: every page of a result, every format it came in and parsed JSON all count, so a three-page search result fits as surely as a single page.
|
|
216
|
+
|
|
217
|
+
## Sync first, queued only on a timeout
|
|
218
|
+
|
|
219
|
+
Every scrape goes to the synchronous endpoint first. If it times out — the API's own timeout, a gateway's 504, or no answer within 200 s — the same request is sent to the corresponding asynchronous endpoint (`/v1/async/...`) and the agent gets a request id to collect; it is not resent to the synchronous endpoint, where it would wait as long again. While a synchronous call runs, the server sends a progress notification every 10 s, so a client that resets its request timeout on progress keeps waiting. `async/...` endpoints passed to `run_scraper` are always queued.
|
|
220
|
+
|
|
221
|
+
```json
|
|
222
|
+
{ "state": "pending", "request_id": "7504857924934611969", "note": "The synchronous call timed out (…), so the same request was queued instead. Collect it with check_requests(['7504857924934611969']) …" }
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
`check_requests` waits for the request to finish (up to 30 s), reporting progress meanwhile, so the agent makes one call instead of polling in a loop it has no way to pace. The API holds the result, so nothing about a request lives in this process: restarts and extra replicas do not lose it.
|
|
226
|
+
|
|
227
|
+
### Many pages in one call
|
|
228
|
+
|
|
229
|
+
`scrape` takes a list of URLs, and `run_scraper` a list of `url`s or `query`s, when every other parameter is the same. Up to five run side by side through the synchronous endpoint; more go to the API's batch endpoint in one request, each item counting against `OXYLABS_RATE_LIMIT`. Either way the call waits for what was queued and answers with an item per URL or query: its state and, for as many as fit the token budget, its result. The rest come as summaries showing as much of each page as there was room for, and anything still running comes as a request id for `check_requests`.
|
|
230
|
+
|
|
231
|
+
### It says when a page needed rendering
|
|
232
|
+
|
|
233
|
+
The agent shouldn't have to guess whether an empty page is empty or just unrendered, and it shouldn't pay for a render on every page to find out. So a plain `scrape` that comes back with almost no visible text — or with a "please enable JavaScript" notice — is flagged:
|
|
234
|
+
|
|
235
|
+
```jsonc
|
|
236
|
+
{
|
|
237
|
+
"content": "# Loading…",
|
|
238
|
+
"content_thin": {
|
|
239
|
+
"visible_chars": 9,
|
|
240
|
+
"reason": "almost no text",
|
|
241
|
+
"note": "…renders client-side. Retry the same call with run_js=True…"
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
```
|
|
245
|
+
|
|
246
|
+
HTML is measured on its text, not its markup, so a 3 KB shell of `<meta>` tags still reads as thin. The flag is a hint, not a retry: rendering is slow and billed, and a genuinely short page would pay for it on every fetch. The threshold is 500 visible characters.
|
|
247
|
+
|
|
248
|
+
## Structured data
|
|
249
|
+
|
|
250
|
+
Request structured data and the server selects the parser for you:
|
|
251
|
+
|
|
252
|
+
- **Dedicated parser** — included at no extra cost. Available on selected target endpoints, it returns that endpoint's predefined structure.
|
|
253
|
+
- **AI parser** — billed on top of the scrape. Available on most endpoints, it returns exactly the fields your prompt or schema describes.
|
|
254
|
+
|
|
255
|
+
To keep costs down, the server tries the dedicated parser first and falls back to the AI parser only when the endpoint has no dedicated parser or the dedicated parse fails. Each result states which parser produced it, and the agent can request the AI parser directly when a dedicated result lacks the fields it needs.
|
|
256
|
+
|
|
257
|
+
## Large pages
|
|
258
|
+
|
|
259
|
+
Web pages routinely exceed what is sensible to hand an agent in one response, so `scrape` does not return oversized content inline:
|
|
260
|
+
|
|
261
|
+
- **Running locally (stdio):** the page is written to the spill directory, named by its request id. The agent gets up to the first 2 000 characters (less when several pages share the reply) and pulls the rest through `read_result(request_id, page, offset)` — reading only as far as it needs instead of paying for the whole page up front.
|
|
262
|
+
- **Running over HTTP (Remote MCP or a self-hosted HTTP server):** there is no shared filesystem. A queued result is read on in parts with the same `read_result`, straight from the API, which keeps it. A synchronous result is not kept by the API, so a page too long for one reply is cut short with a note stating its full length.
|
|
263
|
+
|
|
264
|
+
`search_companies` returns profiles, not a page, so it is fitted differently. Over budget, every company is kept and cut only as far as needed: first to its key facts (name, website, LinkedIn, a 200-character description, industry, type, founding year, employees, headquarters city and country, total funding, revenue), then to its name, website and country. Only if even that does not fit are the lowest-ranked dropped, and a first item too long on its own is cut to its start. A `note` in the reply says what was cut and how to get one company in full: search again with its website domain (`oxylabs.io`) as the `query` and `max_results=1`. Running locally, the full list is also written to the spill directory, and `read_result(request_id, page=0)` reads it in parts. Over HTTP nothing is kept, so that search, a narrower `query` or a smaller `max_results` is the way to get the rest.
|
|
265
|
+
|
|
266
|
+
The threshold is `OXYLABS_MAX_INLINE_TOKENS` (default 10 000). `read_result` reads only the files this server wrote to the spill directory, found by request id — it is deliberately not a general file reader.
|
|
267
|
+
|
|
268
|
+
Full API documentation: **[Oxylabs Web API docs](https://dashboard.oxylabs.io/?utm_source=github&utm_medium=referral&utm_content=web-api-mcp)**
|
|
269
|
+
|
|
270
|
+
### Security notes
|
|
271
|
+
|
|
272
|
+
- **Keep keys out of config files.** Use environment variables or a `.env` file outside version control, and don't commit client configs that contain a key.
|
|
273
|
+
- **Callers can bring their own key over HTTP.** Send `Authorization: Bearer <key>` with each request and the server uses it for that call, so one deployment serves several callers on their own quota. `OXYLABS_WEB_API_KEY` in the server environment is the fallback when no header arrives.
|
|
274
|
+
- **Cap the spend.** `OXYLABS_RATE_LIMIT=100/1h` refuses scrapes past a sliding window, so a runaway agent loop cannot drain the key. Each API key has a window of its own, and each URL or query of a list counts. Off by default. Separately, one call takes at most 50 URLs or queries.
|
|
275
|
+
- **If you rely on that fallback, treat the endpoint as privileged.** The server does no authentication of its own — anyone who can reach it spends the key it holds. Put it behind your VPN, an ingress with auth, or a service mesh. Don't expose it to the public internet.
|
|
276
|
+
- `scrape` fetches whatever URL it is given. If you expose this server to untrusted prompts, restrict egress at the network layer rather than trusting the caller.
|
|
277
|
+
- **The spill directory is private.** By default it is a per-user directory in the system temp dir, readable by you only, and the server refuses a directory someone else owns or a symlink in its place. It deletes its own files there (`<request id>-<page>.<format>.txt` and screenshots) after 6 hours and leaves anything else alone. `read_result` reads only the files this server wrote, found by request id.
|
|
278
|
+
|
|
279
|
+
## Development
|
|
280
|
+
|
|
281
|
+
```bash
|
|
282
|
+
pip install -e '.[dev]'
|
|
283
|
+
ruff check . && ruff format --check .
|
|
284
|
+
pytest
|
|
285
|
+
./scripts/sync-skill.sh # refresh the bundled skill from web-api-skills
|
|
286
|
+
./scripts/sync-skill.sh --check # fail if the bundled skill has drifted
|
|
287
|
+
```
|
|
288
|
+
|
|
289
|
+
The tests are offline: error parsing, input validation, envelope trimming, endpoint-name handling, sync-first scraping with the queued fallback and polling, and the dedicated/AI parser selection. CI runs the same on Python 3.10, 3.12, 3.13 and 3.14, and once more against the lowest dependency versions `pyproject.toml` allows.
|
|
290
|
+
|
|
291
|
+
## Learn More
|
|
292
|
+
|
|
293
|
+
For detailed configuration, advanced usage, and code examples in multiple languages, check the official documentation:
|
|
294
|
+
|
|
295
|
+
- [Oxylabs MCP documentation](https://developers.oxylabs.io/ai-workflows/mcp?utm_source=github&utm_medium=referral&utm_content=web-api-mcp)
|
|
296
|
+
- [Get started with Web API](https://oxylabs.io/products/web-api?utm_source=github&utm_medium=referral&utm_content=web-api-mcp)
|
|
297
|
+
- [Web API documentation](https://developers.oxylabs.io/products/web-api?utm_source=github&utm_medium=referral&utm_content=web-api-mcp)
|
|
298
|
+
|
|
299
|
+
## License
|
|
300
|
+
|
|
301
|
+
MIT
|
|
302
|
+
|
|
303
|
+
## Contact Us
|
|
304
|
+
|
|
305
|
+
If you have questions or need support, reach out to us at [support@oxylabs.io](mailto:support@oxylabs.io), or through live chat in the [Oxylabs Dashboard](https://dashboard.oxylabs.io/). For enterprise inquiries, contact your dedicated account manager.
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
[project]
|
|
2
|
+
name = "oxylabs-web-api-mcp"
|
|
3
|
+
version = "0.3.0"
|
|
4
|
+
description = "Self-hostable MCP server for the Oxylabs Web API (/v1/search, /v1/search/companies, /v1/scrape)"
|
|
5
|
+
requires-python = ">=3.10"
|
|
6
|
+
dependencies = [
|
|
7
|
+
# Imported directly, and no longer brought in by FastMCP 4, which moved to httpx2.
|
|
8
|
+
# 0.28.1 is the oldest FastMCP 3.4 accepts.
|
|
9
|
+
"httpx>=0.28.1,<1",
|
|
10
|
+
# 3.4.3 is the first FastMCP whose HTTP transport takes the host and origin allowlists
|
|
11
|
+
# server.main() passes (tests/test_server.py checks). Capped below the next major:
|
|
12
|
+
# FastMCP majors have changed APIs this server uses.
|
|
13
|
+
"fastmcp>=3.4.3,<5",
|
|
14
|
+
# app.py imports mcp.types.ToolAnnotations, the type FastMCP's decorators take.
|
|
15
|
+
# FastMCP 3.4 runs on mcp 1.x and 4.x on mcp 2.x; client.py reads the client's name
|
|
16
|
+
# under either field spelling.
|
|
17
|
+
"mcp>=1.24,<3",
|
|
18
|
+
]
|
|
19
|
+
|
|
20
|
+
[project.scripts]
|
|
21
|
+
oxylabs-web-api-mcp = "oxylabs_web_api_mcp.server:main"
|
|
22
|
+
|
|
23
|
+
[project.optional-dependencies]
|
|
24
|
+
dev = ["pytest>=8", "ruff>=0.15"]
|
|
25
|
+
|
|
26
|
+
[build-system]
|
|
27
|
+
requires = ["hatchling"]
|
|
28
|
+
build-backend = "hatchling.build"
|
|
29
|
+
|
|
30
|
+
[tool.hatch.build.targets.wheel]
|
|
31
|
+
packages = ["src/oxylabs_web_api_mcp"]
|
|
32
|
+
|
|
33
|
+
[tool.ruff]
|
|
34
|
+
target-version = "py310"
|
|
35
|
+
line-length = 100
|
|
36
|
+
|
|
37
|
+
[tool.ruff.lint]
|
|
38
|
+
select = ["E", "F", "W", "I", "B", "UP", "BLE"]
|
|
39
|
+
|
|
40
|
+
[tool.ruff.lint.per-file-ignores]
|
|
41
|
+
"tests/*" = ["E402", "E501"]
|
|
42
|
+
|
|
43
|
+
[tool.pytest.ini_options]
|
|
44
|
+
testpaths = ["tests"]
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Refresh the bundled skill from its canonical home in the web-api-skills repo.
|
|
3
|
+
# The MCP server serves this file as a resource and a prompt, so it must not drift.
|
|
4
|
+
#
|
|
5
|
+
# ./scripts/sync-skill.sh [SRC] copy SRC over the bundled skill
|
|
6
|
+
# ./scripts/sync-skill.sh --check [SRC] exit 1 if the bundled skill differs from SRC
|
|
7
|
+
#
|
|
8
|
+
# SRC is a path or an https URL. Default: the local web-api-skills checkout next to this repo.
|
|
9
|
+
# Edit the skill in web-api-skills, never the bundled copy: the check fails CI otherwise.
|
|
10
|
+
set -euo pipefail
|
|
11
|
+
check=0
|
|
12
|
+
[ "${1:-}" = "--check" ] && { check=1; shift; }
|
|
13
|
+
src="${1:-../web-api-skills/skills/oxylabs-web-api/SKILL.md}"
|
|
14
|
+
dst="$(cd "$(dirname "$0")/.." && pwd)/src/oxylabs_web_api_mcp/skills/oxylabs-web-api.md"
|
|
15
|
+
|
|
16
|
+
tmp="$(mktemp)"
|
|
17
|
+
trap 'rm -f "$tmp"' EXIT
|
|
18
|
+
case "$src" in
|
|
19
|
+
https://*) curl -fsSL "$src" -o "$tmp" ;;
|
|
20
|
+
*) [ -f "$src" ] || { echo "no skill at $src — pass the path to web-api-skills' SKILL.md"; exit 1; }
|
|
21
|
+
cp "$src" "$tmp" ;;
|
|
22
|
+
esac
|
|
23
|
+
|
|
24
|
+
if [ "$check" = 1 ]; then
|
|
25
|
+
if diff -u "$dst" "$tmp"; then
|
|
26
|
+
echo "bundled skill matches $src"
|
|
27
|
+
else
|
|
28
|
+
echo "::error::bundled skill differs from $src. Make the change in web-api-skills, then run scripts/sync-skill.sh"
|
|
29
|
+
exit 1
|
|
30
|
+
fi
|
|
31
|
+
else
|
|
32
|
+
cp "$tmp" "$dst"
|
|
33
|
+
echo "bundled skill updated from $src"
|
|
34
|
+
fi
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
|
|
3
|
+
"name": "io.oxylabs/web-api-mcp",
|
|
4
|
+
"description": "Search the live web, look up companies and read any page through the Oxylabs Web API.",
|
|
5
|
+
"repository": {
|
|
6
|
+
"url": "https://github.com/oxylabs/web-api-mcp",
|
|
7
|
+
"source": "github"
|
|
8
|
+
},
|
|
9
|
+
"websiteUrl": "https://oxylabs.io",
|
|
10
|
+
"version": "0.3.0",
|
|
11
|
+
"packages": [
|
|
12
|
+
{
|
|
13
|
+
"registryType": "pypi",
|
|
14
|
+
"identifier": "oxylabs-web-api-mcp",
|
|
15
|
+
"version": "0.3.0",
|
|
16
|
+
"transport": { "type": "stdio" },
|
|
17
|
+
"environmentVariables": [
|
|
18
|
+
{
|
|
19
|
+
"name": "OXYLABS_WEB_API_KEY",
|
|
20
|
+
"description": "Oxylabs Web API key, from a Web API instance in the Oxylabs dashboard.",
|
|
21
|
+
"isRequired": true,
|
|
22
|
+
"isSecret": true
|
|
23
|
+
}
|
|
24
|
+
]
|
|
25
|
+
}
|
|
26
|
+
]
|
|
27
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"""MCP server for the Oxylabs Web API."""
|