Skip to main content
Glama

QIT MCP Server

An MCP (Model Context Protocol) server that wraps the QIT CLI, enabling natural language interaction and agent-based workflows for WordPress/WooCommerce plugin testing.

Features

  • Natural Language Testing: Run QIT tests using conversational commands

  • Agent Integration: Enable AI agents to run tests as part of automated workflows

  • Full CLI Coverage: Access all essential QIT CLI functionality through MCP tools

  • Smart CLI Detection: Automatically finds QIT CLI in PATH, local vendor, or custom location

Prerequisites

  • Node.js 18+

  • QIT CLI installed and accessible

Installation

git clone https://github.com/woocommerce/qit-mcp cd qit-mcp npm install npm run build

Configuration

Claude Code

Add to your Claude Code MCP settings (~/.claude.json):

{ "mcpServers": { "qit": { "type": "stdio", "command": "node", "args": ["/path/to/qit-mcp/dist/index.js"], "env": { "QIT_CLI_PATH": "/path/to/qit-cli/qit" } } } }

QIT CLI Detection

The MCP server automatically detects QIT CLI in this order:

  1. QIT_CLI_PATH environment variable

  2. qit in system PATH

  3. ./vendor/bin/qit (local Composer installation)

Available Tools

Authentication (2 tools)

Tool

Description

authenticate

Connect to WooCommerce.com Partner Developer account

get_auth_status

Check current authentication status

Test Execution (2 tools)

Tool

Description

run_test

Run any test type (security, e2e, phpstan, activation, etc.)

run_test_group

Run a predefined test group from qit.json

Test Results (4 tools)

Tool

Description

get_test_result

Get test result(s) by ID

list_tests

List test runs with filters

get_test_report

Get detailed test report

open_test_result

Open result in browser

Groups (1 tool)

Tool

Description

get_group_status

Fetch status of a registered test group

Environment (5 tools)

Tool

Description

start_environment

Start a local test environment

stop_environment

Stop a running environment

list_environments

List running environments

exec_in_environment

Execute command in environment container

reset_environment

Reset environment database

Packages (2 tools)

Tool

Description

manage_package

Manage test packages (publish, download, scaffold, delete, show)

list_packages

List available test packages with filtering

Configuration (1 tool)

Tool

Description

manage_config

Manage backends, partners, and tunneling configuration

Utilities (5 tools)

Tool

Description

list_extensions

List extensions you can test

validate_zip

Validate a plugin ZIP file

manage_cache

Manipulate QIT cache

get_qit_dir

Get QIT config directory path

sync_cache

Re-sync with QIT Manager

Usage Examples

Natural Language (via Claude Code)

"Run security tests on my-plugin" → run_test(type="security", plugin="my-plugin") "Start a test environment with PHP 8.2" → start_environment(php_version="8.2") "Show me my recent failed tests" → list_tests(status="failed") "What plugins can I test?" → list_extensions()

Programmatic Usage

The MCP server communicates via stdio using the Model Context Protocol. See the MCP documentation for integration details.

Development

# Install dependencies npm install # Build npm run build # Watch mode npm run dev # Run tests npm test # Lint npm run lint

License

MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/woocommerce/qit-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server