Skip to main content
mcp-pointer - AI Agents | SkillsLLM
Home AI Agents mcp-pointer MCP tool: let you point at DOM elements for your favorite agentic coding tool. Let AI see what you see.
AI Agentsagentic-coding browser claude-code cursor dom
# Add to your Claude Code skills
git clone https://github.com/etsd-tech/mcp-pointer
👆 MCP Pointer
Point to browser DOM elements for agentic coding tools via MCP!
MCP Pointer is a local tool combining an MCP Server with a Chrome Extension:
🖥️ MCP Server (Node.js package) - Bridges between the browser and AI tools via the Model Context Protocol
🌐 Chrome Extension - Captures DOM element selections in the browser using Option+Click
The extension lets you visually select DOM elements in the browser, and the MCP server makes this textual context available to agentic coding tools like Claude Code, Cursor, and Windsurf through standardized MCP tools.
✨ Features
🎯 Option+Click Selection - Simply hold Option (Alt on Windows) and click any element
📋 Complete Element Data - Text content, CSS classes, HTML attributes, positioning, and styling
Sign in with GitHub to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
dom-element
mcp
mcp-server
pointing
stdio
💡 Dynamic Context Control - Request visible-only text, suppress text entirely, or dial CSS detail from none → full computed styles per MCP call
⚛️ React Component Detection - Component names and source files via Fiber (experimental)
🔗 WebSocket Connection - Real-time communication between browser and AI tools
🤖 MCP Compatible - Works with Claude Code and other MCP-enabled AI tools
🎬 Usage example (video) https://github.com/user-attachments/assets/98c4adf6-1f05-4c9b-be41-0416ab784e2c
See MCP Pointer in action: Option+Click any element in your browser, then ask your agentic coding tool about it (in this example, Claude Code). The AI gets complete textual context about the selected DOM element including CSS properties, url, selector, and more.
🚀 Getting Started
1. Install Chrome Extension 🎉 Now available on Chrome Web Store!
Simply click the link above to install from the Chrome Web Store.
Option A: Download from Releases
Go to GitHub Releases
Download mcp-pointer-chrome-extension.zip from the latest release
Extract the zip file to a folder on your computer
Open Chrome → Settings → Extensions → Developer mode (toggle ON)
Click "Load unpacked" and select the extracted folder
The MCP Pointer extension should appear in your extensions list
Reload web pages to activate the extension
Option B: Build from Source
Clone this repository
Follow the build instructions in CONTRIBUTING.md
Open Chrome → Settings → Extensions → Developer mode (toggle ON)
Click "Load unpacked" and select the packages/chrome-extension/dist/ folder
Reload web pages to activate the extension
2. Configure MCP Server One command setup for your AI tool:
npx -y @mcp-pointer/server config claude # or cursor, windsurf, and others - see below
# For other AI tools
npx -y @mcp-pointer/server config cursor # Opens Cursor deeplink for automatic installation
npx -y @mcp-pointer/server config windsurf # Automatically updates Windsurf config file
npx -y @mcp-pointer/server config manual # Shows manual configuration for other tools
Optional: You can install globally with npm install -g @mcp-pointer/server to use mcp-pointer instead of npx -y @mcp-pointer/server
After configuration, restart your coding tool to load the MCP connection.
🔄 Already using MCP Pointer? Run the config command again to update to auto-updating configuration:
npx -y @mcp-pointer/server config <your-tool> # Reconfigures to always use latest version
3. Start Using
Navigate to any webpage
Option+Click any element to select it
Ask your AI to analyze the targeted element!
Your AI tool will automatically start the MCP server when needed using the npx -y @mcp-pointer/server@latest start command.
get-pointed-element – Returns textual information about the currently pointed DOM element. Optional arguments:
textDetail: 0 | 1 | 2 (default 2) controls how much text to include (0 = none, 1 = visible text only, 2 = visible + hidden).
cssLevel: 0 | 1 | 2 | 3 (default 1) controls styling detail, from no CSS (0) up to full computed styles (3).
🎯 How It Works
Element Selection : Content script captures Option+Click events
Data Extraction : Analyzes element structure, CSS, and framework info
WebSocket Transport : Sends data to MCP server on port 7007
MCP Protocol : Makes data available to AI tools via MCP tools
AI Analysis : Your assistant can now see and analyze the element!
🎨 Element Data Extracted
Basic Info : Tag name, ID, classes, text content
CSS Properties : Display, position, colors, dimensions
Component Info : React component names and source files (experimental)
Attributes : All HTML attributes
Position : Exact coordinates and dimensions
Source Hints : File paths and component origins
🔍 Framework Support
⚛️ React - Component names and source files via Fiber (experimental)
📦 Generic HTML/CSS/JS - Full support for any web content
🔮 Planned - Vue component detection (PRs appreciated)
🌐 Browser Support
✅ Chrome - Full support (tested)
🟡 Chromium-based browsers - Should work (Edge, Brave, Arc - load built extension manually)
🐛 Troubleshooting
Extension Not Connecting
Make sure MCP server is running: npx -y @mcp-pointer/server@latest start
Check browser console for WebSocket errors
Verify port 7007 is not blocked by firewall
MCP Tools Not Available
Restart your AI assistant after installing
Check MCP configuration: mcp-pointer config <your-tool>
Verify server is running: npx -y @mcp-pointer/server@latest start
Elements Not Highlighting
Some pages block content scripts (chrome://, etc.)
Try refreshing the page
Check if targeting is enabled (click extension icon)
🚀 Roadmap
1. Dynamic Context Control
Full raw context transferred to server
LLM-configurable detail levels (visible text only, all text, CSS levels)
Progressive refinement options / token-conscious data fetching
2. Visual Content Support (for multimodal LLMs)
Base64 encoding for images (img tags)
Screenshot capture of selected elements
Separate MCP tool for direct visual content retrieval
3. Enhanced Framework Support
Vue.js component detection
Better React support (React 19 removed _debugSource, affecting source mapping in dev builds)
4. Multi Select
Having the ability to select multiple DOM elements
https://github.com/etsd-tech/mcp-pointer/pull/9
📝 License MIT License - see LICENSE file for details
🤝 Contributing We welcome contributions! Please see our CONTRIBUTING.md guide for development setup and guidelines.
Made with ❤️ for AI-powered web development
Now your AI can analyze any element you point at with Option+Click! 👆
56,706
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
AI Agents ai-agents anthropic
An open-source AI agent that brings the power of Gemini directly into your terminal.
AI Agents ai ai-agents
An AI SKILL that provide design intelligence for building professional UI/UX multiple platforms
CLI Tools ai-skills antigravity
The agent that grows with you
AI Agents ai ai-agent
A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows
AI Agents agent-skills ai-agents