For the complete documentation index, see llms.txt. This page is also available as Markdown.

Interactive Demo

See how Claude and other AI agents use ContextQA's MCP tools to create tests, run them, and analyze failures — all from a natural language conversation.

Connect any MCP-compatible AI client (Claude Desktop, Cursor, VS Code Copilot) to your ContextQA workspace and control your entire test suite through conversation. This demo shows the four most common workflows an AI agent can perform using the ContextQA MCP server.

1

User Prompt

The user asks the AI agent to run a specific test suite and report the results.

User: Run the checkout smoke tests and tell me if they pass.

AI Agent: Calls get_test_suites to retrieve available suites in the workspace, then identifies the matching suite by name.

2

Execute the Suite

The agent triggers execution of the Checkout Smoke Tests suite (8 test cases) and monitors its status.

AI Agent: Calls execute_test_suite to start the run, then polls get_execution_status until the run reaches a completed state.

3

Fetch & Summarize Results ✓

The agent retrieves the per-test results and returns a plain-English summary.

Agent response:

I ran the Checkout Smoke Tests suite (8 tests). Here are the results:

7 passed — all core checkout flows working ❌ 1 failed — "Apply discount code" (Test Case #18754)

The failure was on step 3: the discount code field returned a 422 Unprocessable Entity error when applying code "SAVE10". This looks like an application bug — the promo code validation API is rejecting valid codes. I can fetch the full root cause analysis if you'd like.

1

User Prompt

The user asks the agent to create tests for a new feature.

User: Generate tests for the new discount code feature.

AI Agent: Calls get_test_suites to find the relevant suite where the new tests should be placed.

2

Create Test Cases

The agent generates three test cases covering the happy path, invalid input, and edge cases.

AI Agent: Calls create_test_case three times — valid code, invalid code, and expired code scenarios — each with a distinct description and assigned to the Promotions suite.

3

Confirm & Offer to Run ✓

Agent response:

I generated 3 test cases for the discount code feature and added them to the "Promotions" suite:

  1. TC #18760 — Apply valid code, verify discount applied (6 steps)

  2. TC #18761 — Invalid code shows error message (4 steps)

  3. TC #18762 — Expired code shows expiry message (4 steps)

Would you like me to run them now to validate they pass against your staging environment?

1

User Prompt

The user asks why a specific test failed.

User: Why did test case 18750 fail in the last run?

AI Agent: Calls get_test_case_results to retrieve the execution result for the most recent run of test case 18750.

2

Fetch Root Cause & Logs

The agent retrieves the AI root cause analysis and browser console logs for the failed execution.

AI Agent: Calls get_root_cause for the AI-classified failure summary, then calls get_console_logs to gather supporting browser evidence.

3

Explain the Failure ✓

Agent response:

Test Case #18750 failed on Step 4 ("Click the Sign In button").

AI Classification: APPLICATION BUG

The login button was not found on the page. The console log shows a JavaScript error that suggests the login form component failed to render.

Suggested fix: Check the component for the login page — the form may not be mounting correctly if a required dependency is throwing an error on page load. Review the browser console in your staging environment.

Evidence available: Screenshot at step 4, full console log, HAR network trace. Want me to create a Jira ticket for this?

1

User Prompt

The user asks the agent to create a test plan combining two suites.

User: Create a test plan for the login and checkout flows.

AI Agent: Calls get_test_suites to identify the Login Tests and Checkout Smoke Tests suites, then calls get_environments to list available target environments.

2

Configure & Create the Plan

The agent creates a test plan named "Login + Checkout Gate" with both suites, targeting the staging environment with 5 parallel workers.

AI Agent: Calls save_test_plan with the suite IDs, environment ID, and parallelism settings — the plan is created in a single API call.

3

Confirm & Offer Next Steps ✓

Agent response:

Test Plan created: "Login + Checkout Gate" (Plan ID: 156)

Configuration:

  • Suites: Login Tests (12 cases) + Checkout Smoke Tests (8 cases)

  • Environment: staging

  • Parallel workers: 5

  • Estimated duration: ~3 minutes

I can run it now, schedule it to run on every commit via your CI/CD webhook, or set up a nightly schedule. What would you like to do?

Capability
Detail

MCP Tools Available

67

AI Clients Supported

Claude Desktop, Cursor, VS Code Copilot, any MCP client

Lines of Code to Integrate

0

Setup Time

~10 minutes


Last updated

Was this helpful?