Web Task

io.github.jojo-labs/web-task-api · v0.10.1

Browser tasks, sessions, and recipes for MCP and HTTP automation.

Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add web-task-api -e WEB_TASK_API_DATA_DIR=<WEB_TASK_API_DATA_DIR> -e WEB_TASK_API_RECIPES_DIR=<WEB_TASK_API_RECIPES_DIR> -e WEB_TASK_API_TEMP_DIR=<WEB_TASK_API_TEMP_DIR> -e WEB_TASK_API_MODEL=<WEB_TASK_API_MODEL> -e WEB_TASK_API_VARIANT=<WEB_TASK_API_VARIANT> -e WEB_TASK_API_PI_URL=<WEB_TASK_API_PI_URL> -e WEB_TASK_API_PI_MODEL=<WEB_TASK_API_PI_MODEL> -e WEB_TASK_API_PI_VARIANT=<WEB_TASK_API_PI_VARIANT> -e CLIPROXY_BASE_URL=<CLIPROXY_BASE_URL> -e CLIPROXY_AUTH_TOKEN=<CLIPROXY_AUTH_TOKEN> -e CLIPROXY_MODEL=<CLIPROXY_MODEL> -e OPENCODE_BASE_URL=<OPENCODE_BASE_URL> -e OPENCODE_MODEL=<OPENCODE_MODEL> -e BROWSER_USER_DATA_DIR=<BROWSER_USER_DATA_DIR> -e BROWSER_CHANNEL=<BROWSER_CHANNEL> -e HEADLESS=<HEADLESS> -- npx -y [email protected]

claude_desktop_config.json

{
  "mcpServers": {
    "web-task-api": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "WEB_TASK_API_DATA_DIR": "<WEB_TASK_API_DATA_DIR>",
        "WEB_TASK_API_RECIPES_DIR": "<WEB_TASK_API_RECIPES_DIR>",
        "WEB_TASK_API_TEMP_DIR": "<WEB_TASK_API_TEMP_DIR>",
        "WEB_TASK_API_MODEL": "<WEB_TASK_API_MODEL>",
        "WEB_TASK_API_VARIANT": "<WEB_TASK_API_VARIANT>",
        "WEB_TASK_API_PI_URL": "<WEB_TASK_API_PI_URL>",
        "WEB_TASK_API_PI_MODEL": "<WEB_TASK_API_PI_MODEL>",
        "WEB_TASK_API_PI_VARIANT": "<WEB_TASK_API_PI_VARIANT>",
        "CLIPROXY_BASE_URL": "<CLIPROXY_BASE_URL>",
        "CLIPROXY_AUTH_TOKEN": "<CLIPROXY_AUTH_TOKEN>",
        "CLIPROXY_MODEL": "<CLIPROXY_MODEL>",
        "OPENCODE_BASE_URL": "<OPENCODE_BASE_URL>",
        "OPENCODE_MODEL": "<OPENCODE_MODEL>",
        "BROWSER_USER_DATA_DIR": "<BROWSER_USER_DATA_DIR>",
        "BROWSER_CHANNEL": "<BROWSER_CHANNEL>",
        "HEADLESS": "<HEADLESS>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "web-task-api": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "WEB_TASK_API_DATA_DIR": "<WEB_TASK_API_DATA_DIR>",
        "WEB_TASK_API_RECIPES_DIR": "<WEB_TASK_API_RECIPES_DIR>",
        "WEB_TASK_API_TEMP_DIR": "<WEB_TASK_API_TEMP_DIR>",
        "WEB_TASK_API_MODEL": "<WEB_TASK_API_MODEL>",
        "WEB_TASK_API_VARIANT": "<WEB_TASK_API_VARIANT>",
        "WEB_TASK_API_PI_URL": "<WEB_TASK_API_PI_URL>",
        "WEB_TASK_API_PI_MODEL": "<WEB_TASK_API_PI_MODEL>",
        "WEB_TASK_API_PI_VARIANT": "<WEB_TASK_API_PI_VARIANT>",
        "CLIPROXY_BASE_URL": "<CLIPROXY_BASE_URL>",
        "CLIPROXY_AUTH_TOKEN": "<CLIPROXY_AUTH_TOKEN>",
        "CLIPROXY_MODEL": "<CLIPROXY_MODEL>",
        "OPENCODE_BASE_URL": "<OPENCODE_BASE_URL>",
        "OPENCODE_MODEL": "<OPENCODE_MODEL>",
        "BROWSER_USER_DATA_DIR": "<BROWSER_USER_DATA_DIR>",
        "BROWSER_CHANNEL": "<BROWSER_CHANNEL>",
        "HEADLESS": "<HEADLESS>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "web-task-api": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "WEB_TASK_API_DATA_DIR": "<WEB_TASK_API_DATA_DIR>",
        "WEB_TASK_API_RECIPES_DIR": "<WEB_TASK_API_RECIPES_DIR>",
        "WEB_TASK_API_TEMP_DIR": "<WEB_TASK_API_TEMP_DIR>",
        "WEB_TASK_API_MODEL": "<WEB_TASK_API_MODEL>",
        "WEB_TASK_API_VARIANT": "<WEB_TASK_API_VARIANT>",
        "WEB_TASK_API_PI_URL": "<WEB_TASK_API_PI_URL>",
        "WEB_TASK_API_PI_MODEL": "<WEB_TASK_API_PI_MODEL>",
        "WEB_TASK_API_PI_VARIANT": "<WEB_TASK_API_PI_VARIANT>",
        "CLIPROXY_BASE_URL": "<CLIPROXY_BASE_URL>",
        "CLIPROXY_AUTH_TOKEN": "<CLIPROXY_AUTH_TOKEN>",
        "CLIPROXY_MODEL": "<CLIPROXY_MODEL>",
        "OPENCODE_BASE_URL": "<OPENCODE_BASE_URL>",
        "OPENCODE_MODEL": "<OPENCODE_MODEL>",
        "BROWSER_USER_DATA_DIR": "<BROWSER_USER_DATA_DIR>",
        "BROWSER_CHANNEL": "<BROWSER_CHANNEL>",
        "HEADLESS": "<HEADLESS>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`WEB_TASK_API_DATA_DIR` Optional	Optional mutable data root for web-task-api runs, sessions, profiles, and temp state. When omitted, the runtime uses a platform user-data directory instead of the ambient cwd.
`WEB_TASK_API_RECIPES_DIR` Optional	Optional recipes directory override. When omitted, web-task-api reads bundled recipes from the installed package.
`WEB_TASK_API_TEMP_DIR` Optional	Optional temp root override used when incoming temp env variables point at your home directory or working directory.
`WEB_TASK_API_MODEL` Optional	Optional shared default planner model for catalog-backed PI and OpenCode selections. Defaults to deepseek/deepseek-v4-flash.
`WEB_TASK_API_VARIANT` Optional	Optional shared default planner thinking variant for catalog-backed PI and OpenCode selections. Defaults to high.
`WEB_TASK_API_PI_URL` Optional	Optional PI engine base URL for the preferred planner backend. Defaults to http://127.0.0.1:8793.
`WEB_TASK_API_PI_MODEL` Optional	Optional PI-specific planner model override. Defaults to WEB_TASK_API_MODEL when omitted.
`WEB_TASK_API_PI_VARIANT` Optional	Optional PI-specific thinking variant override. Defaults to WEB_TASK_API_VARIANT when omitted.
`CLIPROXY_BASE_URL` Optional	Optional CLIProxy base URL for the legacy fallback planner backend.
`CLIPROXY_AUTH_TOKEN` Optional, secret	Optional CLIProxy auth token for the legacy fallback planner backend.
`CLIPROXY_MODEL` Optional	Optional CLIProxy model alias for the legacy fallback planner backend.
`OPENCODE_BASE_URL` Optional	Optional OpenCode base URL for the compatibility planner backend.
`OPENCODE_MODEL` Optional	Optional OpenCode model name for the compatibility planner backend. Defaults to WEB_TASK_API_MODEL when omitted.
`BROWSER_USER_DATA_DIR` Optional	Optional existing Chromium/Chrome user-data directory for warmed browser state reuse.
`BROWSER_CHANNEL` Optional	Optional Playwright browser channel override, for example `chrome`.
`HEADLESS` Optional	Optional browser headless toggle. Set `false` to prefer a visible browser.

Details

Package	`[email protected]` (NPM, stdio)
First published	28 May 2026
Last updated	28 May 2026
Registry name	`io.github.jojo-labs/web-task-api`

More productivity servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use Web Task often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-jojo-labs-web-task-api/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-jojo-labs-web-task-api)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.