Skip to content
Back to search

kogiqa-mcp

This web browser has been designed to help your agent debug and develop complex web applications. (MCP Server)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/atagon-gmbh--kogiqa-mcp/badge.svg)](/listings/atagon-gmbh--kogiqa-mcp)

HTML

<a href="/listings/atagon-gmbh--kogiqa-mcp"><img src="/api/listings/atagon-gmbh--kogiqa-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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:

[<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code" />](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%7B%22name%22%3A%22kogiqa-browser%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22kogiqa-mcp%40latest%22%5D%7D) [<img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5" />](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%7B%22name%22%3A%22kogiqa-browser%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22kogiqa-mcp%40latest%22%5D%7D)

Alternatively, install via the VS Code CLI:

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

Cursor

[<img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor" />](https://cursor.com/en/install-mcp?name=kogiqa-browser&config=eyJjb21tYW5kIjoibnB4IGtvZ2lxYS1tY3BAbGF0ZXN0In0=)

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

readme.md · README · 106 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ## kogiQA MCP Web Browser
  2. [![npm version](https://img.shields.io/npm/v/kogiqa-mcp.svg)](https://www.npmjs.com/package/kogiqa-mcp)
  3. [![Total Downloads](https://img.shields.io/npm/dt/kogiqa-mcp.svg)](https://www.npmjs.com/package/kogiqa-mcp)
  4. [![License](https://img.shields.io/npm/l/kogiqa-mcp.svg)](https://www.npmjs.com/package/kogiqa-mcp)
  5. A Model Context Protocol (MCP) server that provides browser automation capabilities using kogiQA. This server
  6. enables LLMs to interact with web pages through natural language, bypassing the need for screenshots
  7. or visually-tuned models.
  8. ### For what to use:
  9. + Debug style issues on your page
  10. + Automatically fix console errors.
  11. + Map and document the functionality of your web app
  12. + Automatically write end-to-end tests
  13. + Automate exploratory testing of your application
  14. See example prompts [Usage Examples](#usage-examples)
  15. ### kogiQA MCP vs Playwright MCP
  16. The kogiQA MCP Server provides a browser which incorporates the capabilities of the kogiQA browser control algorithm.
  17. This enables agents to interact with pages without a selector, saving time and tokens.
  18. ### Installation
  19. Auto install:
  20. ```bash
  21. npx kogiqa-mcp@latest
  22. ```
  23. #### Claude Code
  24. ```bash
  25. claude mcp add kogiqa-browser npx kogiqa-mcp@latest
  26. ```
  27. #### VS Code
  28. Click one of the buttons below to install directly in vs code:
  29. [<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code" />](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%7B%22name%22%3A%22kogiqa-browser%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22kogiqa-mcp%40latest%22%5D%7D) [<img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5" />](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%7B%22name%22%3A%22kogiqa-browser%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22kogiqa-mcp%40latest%22%5D%7D)
  30. Alternatively, install via the VS Code CLI:
  31. ```bash
  32. code --add-mcp '{"name":"kogiqa-browser","command":"npx","args":["kogiqa-mcp@latest"]}'
  33. ```
  34. #### Cursor
  35. [<img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor" />](https://cursor.com/en/install-mcp?name=kogiqa-browser&config=eyJjb21tYW5kIjoibnB4IGtvZ2lxYS1tY3BAbGF0ZXN0In0=)
  36. Alternatively, go to `Cursor Settings` → `MCP` → `Add new MCP Server` and enter the command
  37. `npx kogiqa-mcp@latest`.
  38. ### Standard configuration
  39. For any other MCP client, add the following to your MCP configuration:
  40. ```json
  41. {
  42. "mcpServers": {
  43. "kogiqa-browser": {
  44. "command": "npx",
  45. "args": [
  46. "kogiqa-mcp@latest"
  47. ]
  48. }
  49. }
  50. }
  51. ```
  52. ### Usage Examples
  53. 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.
  54. #### Smoke-test a user flow
  55. ```text
  56. 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".
  57. ```
  58. #### Debug a style issue
  59. ```text
  60. 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.
  61. ```
  62. #### Fix console errors
  63. ```text
  64. Navigate to http://localhost:5173, open every page linked from the main menu, collect all console errors, and fix them in the source code.
  65. ```
  66. #### Map and document your app
  67. ```text
  68. 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.
  69. ```
  70. #### Generate end-to-end tests
  71. ```text
  72. 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.
  73. ```
  74. #### Exploratory testing
  75. ```text
  76. 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.
  77. ```
  78. ### Requirements
  79. + Node.js 20 or newer
  80. + VS Code, Cursor, Windsurf, Claude Desktop, Goose, Junie or a other MCP client

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.