Suitest — MCP-Native Testing Platform

Suitest is a self-hostable, MCP-native quality engineering platform for manual test management, deterministic automation, and optional AI-assisted testing. It is designed around a simple rule: the testing system must remain fully useful without an LLM, and teams should own their infrastructure, model choice, evidence, and data.

The complete product and documentation are available at suitest.suiflex.dev. Suitest can run as a full web platform, as an MCP server inside an IDE agent, or as a local blackbox testing engine.

Deterministic first, AI optional

Suitest's ZERO tier makes no LLM calls. Teams still get manual test-case management, deterministic generators, a runner that executes typed MCP steps, evidence capture, traceability, analytics, integrations, CI webhooks, and rule-based defect handling. A run produces the same result from the same inputs instead of depending on a model to improvise every action.

AI is an explicit workspace-level upgrade rather than a hidden dependency. Configure a local model through Ollama, llama.cpp, vLLM, or LM Studio for the LOCAL tier, or bring a cloud key for Anthropic, OpenAI, Gemini, Groq, OpenRouter, DeepSeek, and other LiteLLM-compatible providers. Keys are encrypted at rest; cloud workspaces also get cost tracking and budget controls.

MCP is the testing plugin layer

Every step that touches an external system is routed through a typed MCP provider. A single test case can combine browser actions, HTTP requests, database assertions, GraphQL or gRPC calls, and infrastructure checks without hard-coding all of those integrations into one runner.

• Browser: deterministic Playwright execution and evidence capture.
• API: REST/HTTP, GraphQL, and gRPC calls.
• Data: PostgreSQL, MySQL, and MongoDB verification or setup steps.
• Infrastructure: Kubernetes assertions and operational checks.
• External tools: extensible MCP registrations for systems such as Jira and GitHub.

Providers expose their tools through standard MCP discovery. Suitest persists the discovered catalog, manages transport sessions and pooling, applies retries and timeouts, streams telemetry through Redis, and attaches artifacts to the exact test step that produced them.

MCP server for coding agents

The standalone @suiflex/suitest-mcp server gives Claude Code, Cursor, Codex, and other MCP clients a 22-tool testing lifecycle. An agent can analyze a repository, plan coverage from a PRD, generate runnable tests, execute them, diagnose failures, capture screenshots and video, and publish cases, runs, and evidence into the web TCM.

The API URL and key are optional. Without a connected Suitest platform, results stay local under suitest-output/; with a connection, the same lifecycle publishes into the shared workspace.

Blackbox testing without repository access

Suitest can start from only a URL and test credentials. Its blackbox DOM workflow provides browser setup, login detection, safe crawling, deterministic Playwright generation, execution, and evidence. This is useful for staging environments, third-party systems, legacy products, and acceptance testing where source access is unavailable or unnecessary.

Web test-case management and evidence

The web platform keeps manual and automated work in the same model: projects, requirements, cases, steps, runs, defects, evidence, traceability, and analytics. Execution logs stream live over WebSocket, while screenshots, video, and other artifacts are stored in MinIO-compatible object storage and linked to the run that created them.

Technology stack

• Backend: Python 3.12, FastAPI, SQLAlchemy 2, and Pydantic.
• Frontend: React 19 with Vite.
• Database: PostgreSQL 16 with pgvector.
• Jobs and live execution: ARQ workers and Redis.
• Artifacts: MinIO/S3-compatible storage.
• AI routing: LiteLLM with optional local or cloud providers.

Install and run

Boot the complete local platform with one command:

npx @suiflex/suitest onboard

Run only the MCP testing server:

npx -y @suiflex/suitest-mcp

For a team deployment, clone the repository, configure the super-admin credentials, and start the prebuilt API, web, and runner images with Docker Compose:

git clone https://github.com/suiflex/suitest
cd suitest
cp .env.example .env
make docker-up

Docker, Helm, and air-gapped deployment paths are documented in the repository. Suitest is licensed under Apache-2.0.