Yad Agent MCP (io.github.holistis/yad-agent-mcp)

An MCP server that wraps Yad, enabling an MCP-compatible client to control Yad’s browser-automation capabilities from an AI agent. It drives navigation and page-reading tasks in the user’s existing, already-logged-in browser via Yad’s local HTTP API.

🛠️ Key Features

Thin MCP wrapper for Yad (local, privacy-first browser automation companion)
Uses Yad’s existing local HTTP API on 127.0.0.1:3747 over stdio
Supports MCP clients to request navigation, reading, and plain-language browser tasks
Local-only by design (not a hosted/remote MCP server)

🚀 Use Cases

Let coding agents perform browser actions in the user’s real session
Retrieve page content by asking the agent to read a page
Execute plain-language automation flows through Yad

⚡ Developer Benefits

Compatible with MCP-compatible clients (e.g., Claude Code, Cursor, Claude Desktop)
No browser runtime included in the MCP server (delegated to Yad)

⚠️ Limitations

Does not run a browser itself; it depends on Yad and its local HTTP API being available
Only usable on the local machine where Yad is running

yad-agent-mcp

An MCP server that lets an AI agent drive Yad, a local, privacy-first browser-automation companion, in the user's real, already-logged-in browser.

This is a thin wrapper: it does not run a browser itself. It talks to Yad's existing local HTTP API on 127.0.0.1:3747 over stdio, so any MCP-compatible client (Claude Code, Cursor, Claude Desktop, etc.) can ask Yad to navigate, read a page, or carry out a plain-language browser task, and get the result back.

Local-only by design. This is not a hosted or remote MCP server. It only works on a machine that already has Yad installed and running (extension in Chrome/Edge/Brave, companion app active). If you're looking for a server your agent can call over the internet with zero local setup, this isn't that, and honestly, nothing that drives a user's real logged-in browser session should be.

Tools

Tool

What it does

yad_status

Checks whether Yad's companion is running and connected to the browser. Call this first.

yad_navigate

Opens a URL in the browser tab Yad controls.

yad_capture

Reads the URL, title, visible text, and links of the current page.

yad_run_goal

Gives Yad a plain-language task ("find the price of the first item", "click the login button") and waits for the result.

yad_last_result

Re-reads the result of the most recent yad_run_goal call.

Yad cannot check out, pay, or place an order without the user's own confirmation, regardless of what an agent asks it to do. This wrapper doesn't add or remove that limit, it's enforced by Yad itself.

Install

Configuration

Environment variables

YAD_COMPANION_URLdefault http://127.0.0.1:3747

Base URL of the local Yad companion's HTTP API. Only needed if it runs on a non-default port.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "yad-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "yad-agent-mcp@0.1.1"
      ],
      "env": {
        "YAD_COMPANION_URL": "http://127.0.0.1:3747"
      }
    }
  }
}

io.github.holistis/yad-agent-mcp

Yad Agent MCP (io.github.holistis/yad-agent-mcp)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

yad-agent-mcp

Requirements

Install

Configure your MCP client

Tools

Source

License

Install

Configuration

Related servers