{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_nwxa5fptjxwa","handle":"peek-mcp","url":"https://wellknown.network/agents/peek-mcp","links":{"self":"https://wellknown.network/agents/peek-mcp/record.json","html":"https://wellknown.network/agents/peek-mcp","markdown":"https://wellknown.network/agents/peek-mcp/record.md","api":"https://wellknown.network/api/v1/agents/peek-mcp","status":"https://wellknown.network/api/v1/agents/peek-mcp/status","claim":"https://wellknown.network/agents/peek-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/peek-mcp/claim.json","badge":"https://wellknown.network/agents/peek-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/peek-mcp/history","tools":"https://wellknown.network/api/v1/agents/peek-mcp/tools"},"ard":{"identifier":"urn:air::server:peek-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"peek-mcp","summary":"Let AI agents see your UI — point at elements, annotate, and get instant visual context for AI-powered code editing.","description":"# Peek\n\nPoint at your UI. Your AI agent sees it.\n\n<p align=\"center\">\n  <img src=\"peek-demo.gif\" alt=\"Peek demo: point at a UI element, agent sees it\" width=\"720\">\n</p>\n\n## Why\n\nAI coding agents can edit code, but they can't see your page. You end up describing layouts in words, copy-pasting HTML, or dragging screenshots into chat.\n\nPeek fixes this. Your AI agent can screenshot any local page on its own. You can also point at specific elements with a bookmarklet, and the agent gets the screenshot plus element data (selectors, styles, bounding boxes).\n\n## Contents\n\n- [Quick Start](#quick-start)\n  - [Claude Code (CLI or VS Code)](#claude-code-cli-or-vs-code)\n  - [Upgrading](#upgrading)\n  - [Other MCP clients (experimental)](#other-mcp-clients-experimental)\n  - [Tell your agent your dev port](#recommended-tell-your-agent-your-dev-port)\n  - [Use it](#use-it)\n- [Supported URLs](#supported-urls)\n- [MCP Tools](#mcp-tools)\n- [How It Works](#how-it-works)\n- [Troubleshooting](#troubleshooting)\n- [Limitations](#limitations)\n- [CLI](#cli)\n\n## Quick Start\n\n### Claude Code (CLI or VS Code)\n\n```bash\n# 1. Install uv (one-time, manages Python for you)\nbrew install uv\n# or: curl -LsSf https://astral.sh/uv/install.sh | sh\n\n# 2. Install peek (uv auto-downloads a compatible Python)\nuv tool install peek-mcp\n\n# 3. One-shot setup\npeek setup\n```\n\n`peek setup` is one-shot: installs Playwright Chromium, registers Peek as an MCP server in Claude Code (user scope, all projects), drops the bookmarklet page at `~/.peek/bookmarklet.html` and opens it in your browser. Drag the blue button to your bookmark bar and you're done; the command exits on its own. Nothing to keep running.\n\nFrom then on: **open Claude Code and use it normally.** It auto-launches Peek in the background whenever the agent uses a Peek tool.\n\n> Using pip directly? `pip install peek-mcp` works too, but requires Python 3.10+ already installed. `uv tool install` avoids the version-mismatch headache.\n\n### Upgrading\n\n```bash\nuv tool …","publisher":null,"homepage":"https://github.com/zly1203/peek","repository":"https://github.com/zly1203/peek","version":"0.5.17","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:peek-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"infra.browser-automation","name":"Browser Automation","confidence":0.836,"provenance":"derived"}],"categories":["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":"peek-mcp","registry":"pypi","observedAt":"2026-11-10T00:24:06.202Z","publishedAt":"2026-07-31T17:00:23.602561Z","latestVersion":"0.5.17"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"peek-mcp","url":"https://pypi.org/project/peek-mcp/","firstSeenAt":"2026-09-10T09:25:58.217Z","fetchedAt":"2026-11-10T00:21:51.315Z","normalizedAt":"2026-11-10T00:21:51.315Z"}]},"firstSeenAt":"2026-09-10T09:25:58.217Z","updatedAt":"2026-11-10T00:24:06.202Z"}