Debugg AIBLOCK
Zero-Config, Fully AI-Managed End-to-End Testing for all code gen platforms.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
AI-powered browser testing via the Model Context Protocol. Point it at any URL (or localhost) and describe what to test — an AI agent browses your app and returns pass/fail with screenshots.
Setup
Requires Node.js 20.20.0 or later (transitive requirement from posthog-node@^5.26.0).
Testing `http://localhost:...` URLs requires the `caddy` binary — check_app_in_browser, probe_page, and trigger_crawl tunnel localhost targets through a local Caddy reverse proxy. This installs automatically: the @radically-straightforward/caddy npm dependency downloads a pinned Caddy release for your platform during npm install/npx — nothing to install yourself in the normal case. It is now the only binary this package downloads; the tunnel client itself is pure TypeScript — it replaced the ngrok package, which fetched the ngrok agent. If that download never ran (npm install --ignore-scripts, an offline/air-gapped install), point CADDY_BIN at your own install (brew install caddy / apt install caddy / see caddyserver.com/docs/install) — missing it surfaces as a clear error on the first localhost-URL call, not a silent hang. Public-URL calls, every non-browser tool, and test_suite {action:"run"} (which uses its own dedicated tunnel and bypasses Caddy entirely) don't need it either way.
Get an API key at debugg.ai, then add to your MCP client config:
{
"mcpServers": {
"debugg-ai": {
"command": "npx",
"args": ["-y", "@debugg-ai/debugg-ai-mcp"],
"env": {
"DEBUGGAI_API_KEY": "your_api_key_here"
}
}
}
}Or with Docker:
docker run -i --rm --init -e DEBUGGAI_API_KEY=your_
5eb6e615cb10OBSERVED · 2026-10-07Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add debugg-ai-mcp --env DEBUGGAI_API_KEY=${DEBUGGAI_API_KEY} --env DEBUGGAI_API_TOKEN=${DEBUGGAI_API_TOKEN} --env DEBUGGAI_JWT_TOKEN=${DEBUGGAI_JWT_TOKEN} --env DEBUGGAI_LIVE_TUNNEL_API_KEY=${DEBUGGAI_LIVE_TUNNEL_API_KEY} -- npx -y @debugg-ai/[email protected]{
"mcpServers": {
"debugg-ai-mcp": {
"command": "npx",
"args": [
"-y",
"@debugg-ai/[email protected]"
],
"env": {
"DEBUGGAI_API_KEY": "${DEBUGGAI_API_KEY}",
"DEBUGGAI_API_TOKEN": "${DEBUGGAI_API_TOKEN}",
"DEBUGGAI_JWT_TOKEN": "${DEBUGGAI_JWT_TOKEN}",
"DEBUGGAI_LIVE_TUNNEL_API_KEY": "${DEBUGGAI_LIVE_TUNNEL_API_KEY}"
}
}
}
}Exposed tools (10)
10 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
S | read | d |
Updated | read | Updated desc |
environment | read | A single environment by UUID, with credentials inline (passwords redacted). |
environments | read | Environments for the auto-detected project (credentials redacted). |
execution | read | A single execution by UUID, with full node detail + artifact links. |
executions | read | Recent workflow executions (first page). |
n | read | d |
new-name | read | updated |
project | read | A single project by UUID, with full detail. |
projects | read | All projects visible to this API key (first page). |
Trust audit
BLOCKgrade D · trust 69/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- declared (2 observation(s))
- Shell
- declared (2 observation(s))
- Dependencies
- not all pinned
- Secrets in source
- found
Findings (25)
? tls.connect({ host, port, servername: host, rejectUnauthorized: false }){"_type":"issue","id":"debugg_ai_mcp-k6yq","title":"probeTunnelHealth returns a FALSE NETWORK_ERROR ~1 in 5 runs (DNS race ~286ms after tunnel creation) — spurious TunnelTrafficBlocked on a healthy sepassword: 'super-secret-password-9876',
expect(isTransientWorkflowError(exec({expect(isTransientWorkflowError(exec({expect(isTransientWorkflowError(exec({expect(isTransientWorkflowError(exec({expect(isTransientWorkflowError(exec({import { loadConfig, config } from '../../config/index.js';import { ToolContext } from '../../types/index.js';jest.unstable_mockModule('../../services/index.js', () => ({jest.unstable_mockModule('../../utils/gitContext.js', () => ({let createEnvironmentHandler: typeof import('../../handlers/createEnvironmentHandler.js').createEnvironmentHandler;target: 'http://169.254.169.254/latest/meta-data/',
host: '169.254.169.254',
{ name: 'PROBE with a URL instead of a path', frame: { type: 'PROBE', streamId: 1, request: { path: 'http://169.254.169.254/' } } },metadata: { kind: 'http', target: '10.0.0.5:22', addr: '169.254.169.254' } as OpenMetadata,addr: '169.254.169.254',
expect(result.data.url).toBe('http://0.0.0.0:8080');base = `http://127.0.0.1:${port}`;expect(handle.localOrigin).toBe(`http://127.0.0.1:${handle.localPort}`);expect(portChangedSpy).toHaveBeenCalledWith(`http://127.0.0.1:${second.localPort}`);@modelcontextprotocol/sdk, @radically-straightforward/caddy, axios, mkdirp, posthog-node, uuid, winston, ws
curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
- **HTTP transport** (`httpServer.ts:95-151`, doc comment: *"Stateless (no session id)... scales behind a plain load balancer"*): the **process** is long-lived, but a fresh `Server`+`StreamableHTTPSer
Gates applied: no_behavioural_pass.
5eb6e615cb10full audit observations/trust-audit/mcp-server/debugg-ai__debugg-ai.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-07 | 5eb6e615cb10 | BLOCK | D | 69 | first audit |
Questions
What is the Debugg AI MCP server?
Zero-Config, Fully AI-Managed End-to-End Testing for all code gen platforms.
What tools does Debugg AI expose?
10 in total: 10 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Debugg AI safe to connect to an agent?
No — not without reading the findings first. The audit graded it D (69/100) and found 1 critical or high issue in the source. Each one is listed on this page with the file and line it is on.
What credentials does Debugg AI need?
It reads DEBUGGAI_API_KEY, DEBUGGAI_API_TOKEN, DEBUGGAI_JWT_TOKEN, DEBUGGAI_LIVE_TUNNEL_API_KEY, DEBUGGAI_OAUTH_ISSUER, DEBUGGAI_TOKEN_TYPE and POSTHOG_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does Debugg AI run?
It speaks stdio and streamable-http, so it runs as a local process your client starts. It is published on npm as @debugg-ai/debugg-ai-mcp at 6.0.2.
How current is this page?
The grade is for one exact copy of the source (5eb6e615cb10), read on 2026-10-07. The repository is watched and re-audited when it changes.