mabl MCP server

The mabl Model Context Protocol (MCP) server lets AI assistants and agents work directly with your mabl tests — run tests, analyze failures, create tests in the cloud, and query results across your workspaces.

This repository hosts the public documentation and registry listing for the hosted mabl MCP server. The server is operated by mabl as a managed remote service — there is nothing to install or self-host.

Registry listing: com.mabl/mcp on the official MCP Registry
Tool reference (always current): https://help.mabl.com/hc/en-us/articles/47047431915284
About mabl: https://www.mabl.com

Endpoints

The server is hosted at mcp.mabl.com and supports two transports:

Transport	URL
Streamable HTTP (recommended)	`https://mcp.mabl.com/mcp`
Server-Sent Events (SSE)	`https://mcp.mabl.com/sse`

Requirements

A mabl account — you sign in with your existing mabl credentials.
The AI-powered tools (failure analysis, results-analysis chat, cloud test generation) require the corresponding mabl AI entitlements on your workspace.

Authentication

The server uses standard MCP OAuth. The first time your client connects it opens a browser to sign in with your mabl identity and authorize access; after that your client caches the token and reconnects automatically — there are no API keys to copy or manage. See docs/authentication.md for the full flow.

Connect a client

Point any MCP-capable client at the Streamable HTTP endpoint https://mcp.mabl.com/mcp (or the SSE endpoint https://mcp.mabl.com/sse for clients that require SSE). A few common clients:

Claude Code

Terminal

claude mcp add --transport http mabl https://mcp.mabl.com/mcp

Codex CLI

bash

codex mcp add mabl --url https://mcp.mabl.com/mcp

Gemini CLI

This repository doubles as a Gemini CLI extension, so it installs in one command — no JSON to edit:

bash

gemini extensions install https://github.com/mablhq/mabl-mcp-server

The extension configures the endpoint and ships a GEMINI.md with guidance on using the mabl tools. Verify it with gemini extensions list.

Cursor / VS Code / other JSON-configured clients

Add an HTTP MCP server entry pointing at the endpoint:

config.json

{
  "mcpServers": {
    "mabl": {
      "type": "http",
      "url": "https://mcp.mabl.com/mcp"
    }
  }
}

Claude Desktop

Add a custom connector with the URL https://mcp.mabl.com/mcp.

On first use, the client will prompt you to sign in to mabl in your browser.

Available tools

The canonical, always-current tool reference is the mabl help center article, regenerated from the live server on every release. docs/TOOLS.md summarizes the high-level tool areas and links to it. You can also call tools/list from any connected client to see exactly what the server exposes.

Support

mabl help center: https://help.mabl.com
Security disclosures: see SECURITY.md

Mabl README