SHAFT MCP

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/SHAFTENGINE/stargazers) [](https://central.sonatype.com/artifact/io.github.shafthq/shaft-engine) [](https://github.com/ShaftHQ/SHAFTENGINE/actions/workflows/e2eTests.yml) [](https://shafthq.github.io/docs/start/overview)

User Guide · Quick Start · 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 | | Create and run a project | Quick start | | Install or generate a project | Installation | | Understand artifacts and boundaries | Architecture and modules | | Test browsers | Web testing | | Test mobile apps | Mobile testing | | Test REST or GraphQL APIs | API testing | | Use agent tools | SHAFT MCP | | Diagnose or recover failed runs | Doctor and Heal | | Upgrade an existing project | Upgrade guide |

Evidence

SHAFT is published on Maven Central, listed in the Selenium ecosystem, and was recognized through the Google Open Source Peer Bonus program.

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. 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
• Source: ShaftHQ/SHAFT_ENGINE
• License: MIT
• Homepage: https://shafthq.github.io/

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