A Model Context Protocol (MCP) server that provides browser automation capabilities using kogiQA. This server enables LLMs to interact with web pages through natural language, bypassing the need for screenshots or visually-tuned models.
- Debug style issues on your page
- Automatically fix console errors.
- Map and document the functionality of your web app
- Automatically write end-to-end tests
- Automate exploratory testing of your application
See example prompts Usage Examples
The kogiQA MCP Server provides a browser which incorporates the capabilities of the kogiQA browser control algorithm. This enables agents to interact with pages without a selector, saving time and tokens.
Auto install:
npx kogiqa-mcp@latestclaude mcp add kogiqa-browser npx kogiqa-mcp@latestClick one of the buttons below to install directly in vs code:
Alternatively, install via the VS Code CLI:
code --add-mcp '{"name":"kogiqa-browser","command":"npx","args":["kogiqa-mcp@latest"]}'Alternatively, go to Cursor Settings → MCP → Add new MCP Server and enter the command
npx kogiqa-mcp@latest.
For any other MCP client, add the following to your MCP configuration:
{
"mcpServers": {
"kogiqa-browser": {
"command": "npx",
"args": [
"kogiqa-mcp@latest"
]
}
}
}Once the server is configured, simply talk to your agent in natural language. Because kogiQA is selector-free, you describe what you want done — not how to find the elements.
Open http://localhost:3000, log in with the demo credentials, add the first product to the cart, and verify that the cart badge shows "1".
Go to https://myapp.example.com/pricing and check why the "Pro" plan card overflows its container on a 1280px-wide viewport. Suggest a CSS fix.
Navigate to http://localhost:5173, open every page linked from the main menu, collect all console errors, and fix them in the source code.
Explore https://staging.example.com, follow all internal links up to two levels deep, and produce a Markdown document describing each page and its main features.
Walk through the sign-up flow at http://localhost:3000/signup and write Cypress end-to-end tests covering the happy path and validation errors.
Do 10 minutes of exploratory testing on http://localhost:8080: try edge-case inputs in every form you find and report anything that looks broken or inconsistent.
- Node.js 20 or newer
- VS Code, Cursor, Windsurf, Claude Desktop, Goose, Junie or a other MCP client