# SHAFT MCP

> SHAFT browser automation, capture, and offline deterministic failure diagnosis

- **Type:** MCP server
- **Install:** `agentstack add mcp-shafthq-shaft-engine`
- **Verified:** Pending review
- **Seller:** [ShaftHQ](https://agentstack.voostack.com/s/shafthq)
- **Installs:** 0
- **Latest version:** 10.2.20260612
- **License:** MIT
- **Upstream author:** [ShaftHQ](https://github.com/ShaftHQ)
- **Source:** https://github.com/ShaftHQ/SHAFT_ENGINE
- **Website:** https://shafthq.github.io/

## Install

```sh
agentstack add mcp-shafthq-shaft-engine
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# SHAFT

### Java 25 automation framework for Web, Mobile, API, CLI, and Database testing.

SHAFT is a Maven-published test automation engine with one fluent API for
synchronized actions, assertions, configuration, test data, reporting, evidence,
and optional agent-assisted workflows.

[](https://github.com/ShaftHQ/SHAFT_ENGINE/stargazers)
[](https://central.sonatype.com/artifact/io.github.shafthq/shaft-engine)
[](https://github.com/ShaftHQ/SHAFT_ENGINE/actions/workflows/e2eTests.yml)
[](https://shafthq.github.io/docs/start/overview)

[User Guide](https://shafthq.github.io/docs/start/overview) ·
[Quick Start](https://shafthq.github.io/docs/start/quick-start) ·
[Architecture](https://shafthq.github.io/docs/features/architecture) ·
[Contribute](CONTRIBUTING.md)

## What SHAFT Provides

- Web, mobile, API, CLI, database, validation, test data, and reporting APIs.
- Built-in synchronization, assertions, screenshots, logs, and Allure evidence.
- TestNG, JUnit 5, and Cucumber integration.
- Required `shaft-engine` runtime plus optional modules for MCP, Capture,
  Doctor, Heal, AI providers, BrowserStack, local video, and visual processing.
- Deterministic agent workflows through SHAFT MCP, Capture, Doctor, and Heal,
  with provider-backed AI features kept optional.

## Go Straight To The Guide

| Goal | Open |
|---|---|
| Evaluate SHAFT quickly | [SHAFT at a glance](https://shafthq.github.io/docs/start/overview) |
| Create and run a project | [Quick start](https://shafthq.github.io/docs/start/quick-start) |
| Install or generate a project | [Installation](https://shafthq.github.io/docs/start/installation) |
| Understand artifacts and boundaries | [Architecture and modules](https://shafthq.github.io/docs/features/architecture) |
| Test browsers | [Web testing](https://shafthq.github.io/docs/testing/web) |
| Test mobile apps | [Mobile testing](https://shafthq.github.io/docs/testing/mobile) |
| Test REST or GraphQL APIs | [API testing](https://shafthq.github.io/docs/testing/api) |
| Use agent tools | [SHAFT MCP](https://shafthq.github.io/docs/agentic/mcp) |
| Diagnose or recover failed runs | [Doctor](https://shafthq.github.io/docs/agentic/doctor) and [Heal](https://shafthq.github.io/docs/agentic/heal) |
| Upgrade an existing project | [Upgrade guide](https://shafthq.github.io/docs/start/upgrade) |

## Evidence

SHAFT is published on
[Maven Central](https://central.sonatype.com/artifact/io.github.shafthq/shaft-engine),
listed in the
[Selenium ecosystem](https://www.selenium.dev/ecosystem/#frameworks), and was
recognized through the
[Google Open Source Peer Bonus program](https://opensource.googleblog.com/2023/05/google-open-source-peer-bonus-program-announces-first-group-of-winners-2023.html).

## Contribute

Read [CONTRIBUTING.md](CONTRIBUTING.md) for the full local setup, validation,
documentation, and pull request checklist.

Public product documentation is maintained in
[ShaftHQ/shafthq.github.io](https://github.com/ShaftHQ/shafthq.github.io).
User-facing engine changes need a linked documentation pull request or a clear
reason why documentation is not required.

MIT licensed. See [LICENSE](LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ShaftHQ](https://github.com/ShaftHQ)
- **Source:** [ShaftHQ/SHAFT_ENGINE](https://github.com/ShaftHQ/SHAFT_ENGINE)
- **License:** MIT
- **Homepage:** https://shafthq.github.io/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Versions

- **10.2.20260612** — security scan: pending review — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-shafthq-shaft-engine
- Seller: https://agentstack.voostack.com/s/shafthq
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.