TestNeo
TestNeo Docs Release Intelligence
Product guide

Release Intelligence — setup & end-to-end

Turn your IDE into a release-confidence engine: validate PRs with PASS / WARN / BLOCK, share results in the web app, and ship with a data-driven Go / No-Go — without leaving Cursor or VS Code.

Primary MCP tool: testneo_pr_validation_workflow — one call returns risk score, findings, fix plan (NOW/NEXT), and a ready-to-paste PR comment. Planning runs without write access; test execution needs confirm: true.
onboard project → build signals (runs & history) → validate every PR → release readiness

The intelligence lifecycle

Phase 1 — Onboard Create a project, connect repo context, optional CI. Enables blast radius and component health.
Phase 2 — Build signals Generate or import tests, run locally or in CI. Each run feeds failure rates, flakiness, and coverage maps.
Phase 3 — Validate & ship Every PR gets impact analysis + risk score. Engineering Memory improves after ~20–30 runs.

Teams with few tests today: start with MCP Customer E2E (generate → run), then return here for PR validation.

What is a release verification?

One release verification (RV) = one PR validation workflow:

  1. Impact analysis on changed files
  2. Risk score (0–100) and PASS / WARN / BLOCK
  3. Optional impacted test execution
  4. Evidence, fix plan, and PR comment draft

Each run is stored at /web/pr-validation/<workflow_id> — share the link in GitHub or Slack.

SignalScoreMeaning
🟢 PASS0–34Low risk; standard review
🟡 WARN35–69Review impacted validation before merge
🔴 BLOCK70–100Blocking findings; hold the release

Setup — MCP in your IDE

1. Account & API key

Sign up → Settings → API keys (tn_…).

2. Cursor mcp.json

{
  "mcpServers": {
    "testneo": {
      "command": "npx",
      "args": ["-y", "@testneo/mcp-server"],
      "env": {
        "TESTNEO_BASE_URL": "https://app.testneo.ai",
        "TESTNEO_API_KEY": "YOUR_API_KEY",
        "TESTNEO_MCP_ALLOW_WRITE": "false"
      }
    }
  }
}

Set TESTNEO_MCP_ALLOW_WRITE to true only when you want test execution inside validation.

3. Verify

In chat: Validate my TestNeo connection or call testneo_validate_connection.

4. IDE playbooks (auto-behavior)

Clone or copy from the TestNeo repo: Cursor uses .cursor/rules/testneo-pr-validation.mdc; VS Code Copilot uses .github/copilot-instructions.md — they auto-detect git context and call testneo_pr_validation_workflow first.

Full install steps: MCP Quickstart.

End-to-end checklist (PR focus)

StepAction
1MCP connected (testneo_validate_connection)
2testneo_list_projects → note <PROJECT_ID>
3Optional: preflight — historical risk on files you are changing
4testneo_pr_validation_workflow with confirm: false (planning)
5Open /web/pr-validation/<workflow_id> in the app
6If BLOCK → testneo_explain_failure + testneo_suggest_fix
7Sprint ship → release readiness / PR history trend

Greenfield (no tests yet)? Run Customer E2E first, then repeat from step 4 on every PR.

Prompt techniques (copy-paste)

Replace <PROJECT_ID> and <PR_NUMBER> with your values. More prompts: MCP Prompt Packs — PR Validation.

Validate PR (planning only)

Ask in Cursor / Copilot:

Validate PR <PR_NUMBER> for project <PROJECT_ID>.
Use git to detect base_sha, head_sha, and changed_files.
Call testneo_pr_validation_workflow with confirm false.
Show PASS/WARN/BLOCK, risk score, top findings, and the PR comment draft.
Give me the workflow_id link to the web board.

Preflight (before you push)

I'm modifying [list files] in project <PROJECT_ID>.
What's the historical failure rate and flakiness on related tests?
Have we seen BLOCK-level PRs on these paths recently?

After BLOCK — explain & fix

Explain why this PR is blocked — root cause per finding.
Then give me the NOW/NEXT fix plan and which tests to rerun.

Release readiness (end of sprint)

Is project <PROJECT_ID> ready to release to production?
Give me release confidence and a Go / No-Go verdict with top risks.

PR risk trend

Show recent PR validation history for project <PROJECT_ID> —
what's the risk trend over the last two weeks?

Web UI (same data as MCP)

  • PR Validation board/web/pr-validation
  • PR detail/web/pr-validation/<workflow_id>
  • Branch health — Analytics → Branch (CI + PR risk overlay)
  • Release readiness — confidence score and ship checklist

Tool reference and JSON contracts: PR Validation & Release Confidence.

Plans & limits

PlanRelease verifications / 30dMCP writes / day
Free10050
Pro300 per userUnlimited
Team2000 shared poolUnlimited

Errors: release_verification_limit_reached (monthly RV cap) or MCP 403 (daily write cap on Free). See MCP troubleshooting — limits.

Last updated June 2026 · Aligns with TestNeo API docs (docs/product/RELEASE_INTELLIGENCE_GETTING_STARTED.md).