kogiQA MCP Web Browser

official

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

GitHub
144

What can you do with Kogi QA Web Browser MCP?

  • Debug style issues — Ask the agent to inspect a page at a specific viewport width, identify layout problems, and suggest CSS fixes.
  • Fix console errors automatically — Have the agent navigate all pages linked from a menu, collect console errors, and apply fixes in source code.
  • Map and document web app functionality — Instruct the agent to crawl internal links up to a set depth and produce a Markdown document describing each page and its features.
  • Generate end-to-end tests — Describe a user flow (e.g., sign-up) and ask the agent to walk through it and output Cypress tests covering happy path and validation errors.
  • Perform exploratory testing — Request time-boxed exploratory testing with edge-case inputs on every form, with a report of anything broken or inconsistent.

Documentation

kogiQA MCP Web Browser

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.

For what to use:

  • 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

kogiQA MCP vs Playwright MCP

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.

Installation

Auto install:

npx kogiqa-mcp@latest

Claude Code

claude mcp add kogiqa-browser npx kogiqa-mcp@latest

VS Code

Click one of the buttons below to install directly in vs code:

Install in VS Code Install in VS Code Insiders

Alternatively, install via the VS Code CLI:

code --add-mcp '{"name":"kogiqa-browser","command":"npx","args":["kogiqa-mcp@latest"]}'

Cursor

Install in Cursor

Alternatively, go to Cursor Settings → MCP → Add new MCP Server and enter the commandnpx kogiqa-mcp@latest.

Standard configuration

For any other MCP client, add the following to your MCP configuration:

{ "mcpServers": { "kogiqa-browser": { "command": "npx", "args": [ "kogiqa-mcp@latest" ] } } }

Usage Examples

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.

Smoke-test a user flow

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".

Debug a style issue

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.

Fix console errors

Navigate to http://localhost:5173, open every page linked from the main menu, collect all console errors, and fix them in the source code.

Map and document your app

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.

Generate end-to-end tests

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.

Exploratory testing

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.

Requirements

  • Node.js 20 or newer
  • VS Code, Cursor, Windsurf, Claude Desktop, Goose, Junie or a other MCP client