{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_6ygxv428j6kc","handle":"agent-viewer-mcp","url":"https://wellknown.network/agents/agent-viewer-mcp","links":{"self":"https://wellknown.network/agents/agent-viewer-mcp/record.json","html":"https://wellknown.network/agents/agent-viewer-mcp","markdown":"https://wellknown.network/agents/agent-viewer-mcp/record.md","api":"https://wellknown.network/api/v1/agents/agent-viewer-mcp","status":"https://wellknown.network/api/v1/agents/agent-viewer-mcp/status","claim":"https://wellknown.network/agents/agent-viewer-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/agent-viewer-mcp/claim.json","badge":"https://wellknown.network/agents/agent-viewer-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/agent-viewer-mcp/history","tools":"https://wellknown.network/api/v1/agents/agent-viewer-mcp/tools"},"ard":{"identifier":"urn:air::server:agent-viewer-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"agent-viewer-mcp","summary":"MCP server + HTTP bridge that give AI agents a visible browser: a virtual cursor glides and clicks on a real Chromium window.","description":"# agent-viewer \n \n> Give your AI agent a **visible** browser. `agent-viewer` is an \n> [MCP](https://modelcontextprotocol.io) server (plus a standalone HTTP bridge) \n> that lets a model drive a real Chromium window — and you can **watch** it work, \n> because a virtual cursor glides to each target and clicks. \n \n[![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/) \n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) \n[![MCP](https://img.shields.io/badge/MCP-server-6E56CF.svg)](https://modelcontextprotocol.io) \n[![Playwright](https://img.shields.io/badge/driven%20by-Playwright-2EAD33.svg)](https://playwright.dev/python/) \n \n--- \n \n## Features \n \n- **MCP server** — Cline / Claude Desktop / Cursor / any MCP host gets \n  `browser_*` tools and can drive the browser on its own. \n- **Visible cursor overlay** — a red dot glides to each target with a click ripple. \n- **Standalone HTTP bridge** — the same engine over `http://127.0.0.1:8765`, with a \n  small CLI client (`av`) for scripts or manual use. \n- **Survives navigation** — the overlay is injected on every page via an init script. \n- **Image-map aware** — can click `<area>` regions of HTML image maps. \n- **Headful or headless**, configurable animation speed, idle auto-shutdown. \n \n## Requirements \n \n- Python 3.10+ \n- [Playwright](https://playwright.dev/python/) (Chromium is fetched automatically) \n \n## Install \n \n```bash \npip install agent-viewer-mcp \npython -m playwright install chromium \n``` \n \nOr from source: \n \n```bash \ngit clone https://github.com/fatunkaz/agent-viewer.git \ncd agent-viewer \npip install -r requirements.txt \npython -m playwright install chromium \n``` \n \n## Use it from your AI agent (MCP) \n \nAdd the server to your MCP host. For **Cline** (`~/.cline/mcp.json`, or the MCP \npanel in the IDE): \n \n```json \n{ \n  \"mcpServers\": { \n    \"agent-viewer\": { \n      \"command\": \"uvx\", \n      \"args\": [\"--from\", \"agent-viewer-mcp\", \"agent-viewer-mcp\"], \n  …","publisher":{"name":"fatunkaz","url":null},"homepage":"https://github.com/fatunkaz/agent-viewer","repository":"https://github.com/fatunkaz/agent-viewer","version":"0.2.0","license":"MIT License \n         \n        Copyright (c) 2026 fatunkaz \n   …","protocols":["mcp"],"tags":["mcp","model-context-protocol","automation","playwright","browser","agent","cline","rpa"],"pricing":null,"endpoints":[{"url":"pypi:agent-viewer-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"infra.browser-automation","name":"Browser Automation","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev","infra"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"agent-viewer-mcp","registry":"pypi","observedAt":"2026-11-05T21:26:26.737Z","publishedAt":"2026-10-03T18:59:42.700918Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"agent-viewer-mcp","url":"https://pypi.org/project/agent-viewer-mcp/","firstSeenAt":"2026-10-06T13:22:25.384Z","fetchedAt":"2026-11-05T21:24:17.681Z","normalizedAt":"2026-11-05T21:24:17.681Z"}]},"firstSeenAt":"2026-10-06T13:22:25.384Z","updatedAt":"2026-11-05T21:26:26.737Z"}