Aiquaa MCP Server

MCP server that generates AIQUAA BDD and Playwright artifacts with business-rule traceability.

Local serverstdioTypeScript

What is the Aiquaa MCP server?

Most browser automation work still happens through a UI a human drives. Aiquaa MCP server moves it into the conversation instead. MCP server that generates AIQUAA BDD and Playwright artifacts with business-rule traceability.

The short version

El resultado no es un test aislado. Es una cadena de evidencia:

Getting it running

aiquaa-playwright-mcp-server on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

The tools it exposes

The server publishes 8 tools. What each one is for:

  • qa_bdd — Features Gherkin desde texto o requirement_id
  • qa_pruebas — Steps, hooks, reporter, configuración, auth y pipelines
  • qa_reglas — Reglas paginadas con filtros
  • qa_mapear — Features etiquetados con @rule:
  • qa_cobertura — Cobertura y estado por regla/feature
  • qa_contexto — Contexto estructural enfocado mediante CodeGraph
  • qa_memoria — Decisiones y aprendizajes recuperados desde Engram
  • qa_recordar — Memoria curada e idempotente por topic_key

What it needs from you

Configuration is passed through the environment: CODEGRAPH_BIN, CODEGRAPH_ALLOWED_ROOTS, ENGRAM_BIN, ENGRAM_PROJECT_PREFIX, AIQUAA_API_BASE_URL, AIQUAA_ACCESS_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

This sits in the browser automation group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Aiquaa's toolset — qa_bdd, qa_pruebas, qa_reglas and 5 more — is a fair guide to whether it matches your workflow. It is maintained by GitHub Actions; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
qa_bddFeatures Gherkin desde texto o requirement_id
qa_pruebasSteps, hooks, reporter, configuración, auth y pipelines
qa_reglasReglas paginadas con filtros
qa_mapearFeatures etiquetados con @rule:<ID>
qa_coberturaCobertura y estado por regla/feature
qa_contextoContexto estructural enfocado mediante CodeGraph
qa_memoriaDecisiones y aprendizajes recuperados desde Engram
qa_recordarMemoria curada e idempotente por topic_key

How to install the Aiquaa MCP server

{
  "mcpServers": {
    "aiquaa-playwright": {
      "command": "npx",
      "args": ["-y", "aiquaa-playwright-mcp-server"],
      "env": {
        "CODEGRAPH_BIN": "your-value",
        "CODEGRAPH_ALLOWED_ROOTS": "your-value",
        "ENGRAM_BIN": "your-value",
        "ENGRAM_PROJECT_PREFIX": "your-value",
        "AIQUAA_API_BASE_URL": "your-value",
        "AIQUAA_ACCESS_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
CODEGRAPH_BINConfiguration value read at startup.Optional
CODEGRAPH_ALLOWED_ROOTSConfiguration value read at startup.Optional
ENGRAM_BINConfiguration value read at startup.Optional
ENGRAM_PROJECT_PREFIXConfiguration value read at startup.Optional
AIQUAA_API_BASE_URLEndpoint or connection string the server talks to.Yes
AIQUAA_ACCESS_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Aiquaa to qa bdd.
  • Use Aiquaa to qa pruebas.
  • Use Aiquaa to qa reglas.

Frequently asked questions

It connects Aiquaa to MCP-compatible AI assistants such as Claude and Cursor, exposing 8 tools (qa_bdd, qa_pruebas, qa_reglas, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Aiquaa directly.