{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_9cqsver5v3cf","handle":"lens-studio-mcp","url":"https://wellknown.network/agents/lens-studio-mcp","links":{"self":"https://wellknown.network/agents/lens-studio-mcp/record.json","html":"https://wellknown.network/agents/lens-studio-mcp","markdown":"https://wellknown.network/agents/lens-studio-mcp/record.md","api":"https://wellknown.network/api/v1/agents/lens-studio-mcp","status":"https://wellknown.network/api/v1/agents/lens-studio-mcp/status","claim":"https://wellknown.network/agents/lens-studio-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/lens-studio-mcp/claim.json","badge":"https://wellknown.network/agents/lens-studio-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/lens-studio-mcp/history","tools":"https://wellknown.network/api/v1/agents/lens-studio-mcp/tools"},"ard":{"identifier":"urn:air::server:lens-studio-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"lens-studio-mcp","summary":"MCP server that proxies AI agent requests to Lens Studio's built-in MCP server","description":"# lens-studio-mcp\n\nAn MCP (Model Context Protocol) server that connects **any AI coding agent** to **Lens Studio** in real-time. Tell your AI to build an AR lens and watch it happen live.\n\nNo plugins required — works with Lens Studio 5.15+'s built-in MCP endpoint.\n\nCompatible with: **Claude Desktop**, **Claude Code**, **Cursor**, **Windsurf**, **VS Code Copilot**, **OpenAI agents**, and any MCP-compatible client.\n\n## How It Works\n\n```\nAI Agent  ←─ MCP (stdio/SSE/HTTP) ─→  lens-studio-mcp  ←─ HTTP JSON-RPC ─→  Lens Studio (port 50050)\n```\n\nLens Studio 5.15+ ships with a built-in HTTP MCP server at `localhost:50050/mcp`. This package is a thin proxy that:\n\n1. Discovers all tools from Lens Studio's API\n2. Registers them as MCP tools with friendly wrappers\n3. Forwards tool calls via HTTP and handles authentication\n4. Adds convenience tools for face filters, materials, colors, and macOS UI automation\n\n## Installation\n\n### From PyPI (recommended)\n\n```bash\npip install lens-studio-mcp\n```\n\n### From source\n\n```bash\ngit clone https://github.com/superdwayne/lens-studio-mcp.git\ncd lens-studio-mcp\npip install -e .\n```\n\n## Quick Start\n\n### 1. Open Lens Studio\n\nLaunch **Lens Studio 5.15+** and open or create a project. The built-in MCP server starts automatically on port 50050.\n\n### 2. Configure your AI agent\n\nAdd `lens-studio-mcp` to your editor's MCP configuration:\n\n**Windsurf** (`.windsurf/mcp.json` or project `.mcp.json`):\n```json\n{\n  \"mcpServers\": {\n    \"lens-studio\": {\n      \"command\": \"lens-studio-mcp\",\n      \"args\": [\"--transport\", \"stdio\"]\n    }\n  }\n}\n```\n\n**Claude Desktop** (`claude_desktop_config.json`):\n```json\n{\n  \"mcpServers\": {\n    \"lens-studio\": {\n      \"command\": \"lens-studio-mcp\",\n      \"args\": [\"--transport\", \"stdio\"]\n    }\n  }\n}\n```\n\n**Cursor** (`.cursor/mcp.json`):\n```json\n{\n  \"mcpServers\": {\n    \"lens-studio\": {\n      \"command\": \"lens-studio-mcp\",\n      \"args\": [\"--transport\", \"stdio\"]\n    }\n  }\n}\n```\n\n**SSE transport** (for remote/web clients):\n```bash\nlens…","publisher":{"name":"Dwayne","url":null},"homepage":"https://github.com/superdwayne/lens-studio-mcp","repository":"https://github.com/superdwayne/lens-studio-mcp","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["ai-agent","ar","augmented-reality","lens-studio","mcp","snapchat"],"pricing":null,"endpoints":[{"url":"pypi:lens-studio-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","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"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":"lens-studio-mcp","registry":"pypi","observedAt":"2026-11-09T13:28:46.973Z","publishedAt":"2026-02-10T10:43:12.651408Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"lens-studio-mcp","url":"https://pypi.org/project/lens-studio-mcp/","firstSeenAt":"2026-09-09T23:25:19.077Z","fetchedAt":"2026-11-09T13:26:54.372Z","normalizedAt":"2026-11-09T13:26:54.372Z"}]},"firstSeenAt":"2026-09-09T23:25:19.077Z","updatedAt":"2026-11-09T13:28:46.973Z"}