explaingit

atagon-gmbh/kogiqa-mcp

Analysis updated 2026-05-18

151JavaScriptAudience · developerComplexity · 2/5Setup · easy

TLDR

An MCP server that lets an AI assistant control a real web browser using plain language instead of screenshots or selectors.

Mindmap

mindmap
  root((kogiQA MCP))
    What it does
      Browser automation via MCP
      Natural language control
      No selectors needed
    Tech stack
      JavaScript
      Node.js
      Model Context Protocol
    Use cases
      Debug console errors
      Write end to end tests
      Explore and document apps
    Audience
      Developers
      QA testers
      AI agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Have an AI assistant debug a CSS layout problem on a live web page just by describing the issue.

USE CASE 2

Automatically write Cypress end to end tests by walking an assistant through a sign up flow in plain language.

USE CASE 3

Crawl a staging site with an assistant and generate a Markdown document describing every page it finds.

USE CASE 4

Run open ended exploratory testing where the assistant tries edge case inputs and reports what breaks.

What is it built with?

JavaScriptNode.jsMCP

How does it compare?

atagon-gmbh/kogiqa-mcpfoundzigu/smsbazaarmrdoob/draco.js
Stars151150153
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyeasy
Complexity2/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Node.js 20 or newer and an MCP-compatible client like Claude Code, Cursor, or VS Code.

In plain English

kogiQA MCP Web Browser is a server that follows the Model Context Protocol, or MCP, a standard that lets AI assistants call external tools. This particular server gives an AI assistant control of a web browser, so it can open pages, click things, and read what is on screen, all described through plain natural language instructions rather than screenshots or coordinates. Because it works without needing to point at specific page elements by name, the README says it saves time and reduces how much text the assistant has to process compared to tools that require selectors. The README lists several ways people use it: finding and describing style problems on a page, automatically fixing errors that show up in the browser console, exploring an app to write documentation of what each page does, generating end to end tests such as Cypress tests from a walkthrough of a user flow, and doing open ended exploratory testing where the assistant tries different inputs and reports anything broken. Installing it is a single command, npx kogiqa-mcp@latest, and the README gives specific setup steps for Claude Code, VS Code, and Cursor, plus a generic JSON configuration block for any other MCP compatible client. Once configured, a user talks to their AI assistant normally, for example asking it to open a local site, log in with test credentials, add an item to a cart, and check that a cart counter updates correctly. Other example prompts include checking why a pricing page element overflows its container at a certain screen width, or crawling a staging site up to two levels deep and writing a document describing every page found. Using it requires Node.js version 20 or newer and an MCP capable client such as VS Code, Cursor, Windsurf, Claude Desktop, Goose, or Junie. The README does not state what license the project is released under.

Copy-paste prompts

Prompt 1
Help me install kogiqa-mcp in Claude Code and configure it as an MCP server.
Prompt 2
Write a prompt I can give my AI assistant to smoke-test my app's login and add-to-cart flow using kogiQA MCP.
Prompt 3
Show me how to ask kogiQA MCP to find and fix console errors across every page linked from my site's main menu.
Prompt 4
Explain how kogiQA MCP's selector-free browser control differs from tools that require CSS selectors.

Frequently asked questions

What is kogiqa-mcp?

An MCP server that lets an AI assistant control a real web browser using plain language instead of screenshots or selectors.

What language is kogiqa-mcp written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, MCP.

How hard is kogiqa-mcp to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is kogiqa-mcp for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.