# oassis — web scraping, crawling and browser control for AI agents MCP server

Web Tools and Web Tasks for AI agents. 100-credit MCP trial; API-key credits or x402.

## At a glance

oassis — web scraping, crawling and browser control for AI agents is an MCP server in the Web & Search category. It is hosted remotely and connects over HTTP, and declares no required credentials. It exposes 14 tools, including web_scrape, web_session_open and web_act. It scores D (33/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install oassis — web scraping, crawling and browser control for AI agents in Claude Code

1. Add the server

```bash
claude mcp add --transport http scraper-crawler https://api.oassis.dev/mcp
```

2. Verify it's connected

```bash
claude mcp list
```

3. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

4. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. web_scrape, web_session_open, web_act). It discovers them automatically.

### How to install oassis — web scraping, crawling and browser control for AI agents in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "scraper-crawler": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.oassis.dev/mcp"
      ]
    }
  }
}
```

3. Why the wrapper?

   This is a remote (HTTP) server and Claude Desktop only launches local processes, so mcp-remote proxies the connection. It will open a browser window if the server needs OAuth.

4. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install oassis — web scraping, crawling and browser control for AI agents in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "scraper-crawler": {
      "url": "https://api.oassis.dev/mcp"
    }
  }
}
```

2. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install oassis — web scraping, crawling and browser control for AI agents in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.scraper-crawler]
command = "npx"
args = ["-y", "mcp-remote", "https://api.oassis.dev/mcp"]
```

2. Why the wrapper?

   Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.

3. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install oassis — web scraping, crawling and browser control for AI agents in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "scraper-crawler": {
      "serverUrl": "https://api.oassis.dev/mcp"
    }
  }
}
```

2. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install oassis — web scraping, crawling and browser control for AI agents in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "scraper-crawler": {
      "type": "streamableHttp",
      "url": "https://api.oassis.dev/mcp"
    }
  }
}
```

### How to install oassis — web scraping, crawling and browser control for AI agents in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "scraper-crawler": {
      "type": "http",
      "url": "https://api.oassis.dev/mcp"
    }
  }
}
```

2. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `web_scrape` — Processes a page and returns every output you ask for at once: markdown, html, links, screenshot, PDF, accessibility tree, elements by selector, AI-structured data, and `controls` (what can be clicked). One call, and a partial failure does not void the rest. From 1 credit ($0.002) per output. A url pointing at a PDF, Word, Excel or CSV file is converted to markdown instead, with no browser, for $0
- `web_session_open` — Opens a browser session and returns the map of controls. Opening costs 2.5 credits plus the requested outputs; the first minute is included. Further started minutes cost 2 credits with an account key. Use web_act to interact and web_session_close when done. API key and credits required. Reference: https://oassis.dev/openapi.json
- `web_act` — Runs actions against an open session and returns the resulting state. Actions: {navigate}, {click:{ref}}, {type:{ref,text,clear}}, {select:{ref,value}}, {press}, {scroll}, {wait}, {back}. The `ref` is the one `controls` gave you. It stops at the first failure and tells you where. $0.0005 (0.25 credit) per action, plus requested outputs and any outstanding browser time. API key and credits required
- `web_scrape_batch` — A batch OF SCRAPES: reads a list of urls YOU give it (2 to 50, from any sites) and returns a jobId. It discovers nothing on its own — for that use web_crawl. API key and credits required. Poll it with web_batch_status.
- `web_batch_status` — Checks a batch of scrapes: status, how many are done, and the results. Free for the owning account. Pass `cancel: true` to stop it.
- `web_map` — Every url of a site, fast and cheap: its sitemap plus, optionally, the links on the page. Use it BEFORE crawling, to see what is there and decide what is worth reading. 1 credit ($0.002) with `includePage: false` (no browser at all), 1.5 credits ($0.003) with the page. Reference for the oassis API: https://oassis.dev/openapi.json
- `web_crawl` — Follows a site's links and reads every page. Returns a jobId; poll it with web_crawl_status. API key and credits required; `limit` controls the maximum pages charged. Use web_map first if you only need the urls. Reference for the oassis API: https://oassis.dev/openapi.json
- `web_crawl_status` — Checks a crawl: status, pages read, discovered and still queued, and the pages themselves. Free for the owning account. Pass `cancel: true` to stop it.
- `web_search_exa` — Search the web with Exa's index: a query instead of a url, for when you do not know where to look. Returns title, url and a snippet per result. To read the pages, pass the urls to web_scrape_batch. The engine is named because the price is Exa's, passed through with no markup and read from its own payment challenge on every call — the quote is read at execution time and is not a guaranteed fixed pr
- `web_feedback` — Tell us an answer was good or bad. FREE. Use it when a result is wrong — empty markdown, a control map missing a button, data that does not match the page — with the url or the jobId so it can be reproduced. It is the only way we learn that we read a page badly: our logs cannot tell that apart from a page that is simply like that. Reference for the oassis API: https://oassis.dev/openapi.json
- `web_task_start` — Starts a research task: a question answered by reading public pages, with sources, progress and cost. Requires an API key and credits. The maximum budget is reserved, actual execution cost is charged, and unused credits are released. Returns a task id: check it with web_task_status.
- `web_task_status` — Returns a task's status, progress, sources, limitations, result and billing. Only your own tasks.
- `web_task_cancel` — Stops a task using its owning API key, or its legacy access_token. No new operations start. Cancellation is free; unused account credit reservations are released. Cancelling a finished task changes nothing.
- `web_session_close` — Closes the browser session and stops its time. HTTP equivalent: POST /web/v1/session/{id}/close. No additional close fee; outstanding browser time is settled when applicable. If you do not close it, it closes itself after a minute without use.

---

Source: https://mcp-skills-hub.vercel.app/mcps/dev-oassis-scraper-crawler · MCP Skills Hub · data as of 2026-10-28T12:31:05Z