mabl
Run mabl tests, analyze test failures, and query results across your mabl workspaces.
Open source Open in the app JSON README (API)
About
Run mabl tests, analyze test failures, and query results across your mabl workspaces.
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- mablhq
- Origin
- gemini
- Category
- ferramentas
- Version
- 1.0.3
- Last push
- 2026-08-11T20:05:54Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
mablhq/mabl-mcp-server
README
# 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
```
### Codex CLI
```bash
codex mcp add mabl --url 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.