mabl-mcp-server

# mabl MCP server

The mabl [Model Context Protocol](https://modelcontextprotocol.io) (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`](https://registry.modelcontextprotocol.io) 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](https://www.mabl.com) 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](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

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

### Gemini CLI

This repository doubles as a [Gemini CLI extension](https://geminicli.com/docs/extensions),
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:

```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](https://help.mabl.com/hc/en-us/articles/47047431915284),
regenerated from the live server on every release. [docs/TOOLS.md](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](SECURITY.md)

## License

[MIT](LICENSE) © 2026 mabl, Inc.