ProdVerdict for AI agents
Tell Cursor: "Set up ProdVerdict for this repo." Your agent runs the bootstrap and only asks for keys if they are missing. Deterministic checks — no LLM in the evaluation path. Billing secrets stay on your machine; remote MCP runs config, migration, boundary, and webhook via GitHub only.
Canceled in billing, still Pro in your app - demo shows FAIL
Run npx prodverdict demo - no API keys. Wrongful-access scenario by default.
0:00 Hook/0:05 Mismatch/0:12 Cost/0:18 FAIL/0:37 Architecture/0:48 CI/0:56 CTA
0. Install agent skills
Works before any repo files exist. Tell Cursor: "Set up ProdVerdict for this repo." Bootstrap also copies skills into .cursor/skills/.
npx skills add prodv-dev/prodverdict-sdk@prodverdict-setup -g -ynpx skills add prodv-dev/prodverdict-sdk@prodverdict-verify -g -y1. Fixture demo (no API keys)
Clone the public SDK and run an Access FAIL scenario in about 60 seconds.
1. Demo (no credentials)
npx prodverdict demo2. Scan your repo
npx prodverdict scan3. Interactive setup
npx prodverdict setup4. Health check
npx prodverdict status2. Tell your AI to set it up
Non-interactive bootstrap — config, scheduled workflow, MCP, agent rule, and team skills. Wires env from .env.local when present.
npx prodverdict setup --yes --format agent --from-envOr MCP tool bootstrap_prodverdict. AI setup guide · Agent skills
3. Agent verify loop
Stable JSON with summary and next steps (schemaVersion: "1").
npx prodverdict doctor --format agentnpx prodverdict check all --format agent4. GitHub Action — contract: all
Run every configured contract in one CI job.
- uses: prodv-dev/prodverdict-action@v1
with:
config: ./prodverdict.yml
contract: all5. Local MCP (all contracts — secrets on your machine)
Tools: bootstrap_prodverdict, doctor, check_all_contracts, check_*_contract (access, config, migration, boundary, webhook, restore), validate_config, suggest_fix. Prompts: setup_prodverdict, verify_before_pr.
{
"mcpServers": {
"prodverdict": {
"command": "npx",
"args": ["-y", "@prodverdict/mcp"],
"env": {
"DATABASE_URL": "postgresql://readonly:...@host/db",
"STRIPE_SECRET_KEY": "rk_live_..."
}
}
}
}6. Remote MCP (Pro Cloud)
For Cursor cloud agents. GitHub App connect is free. Repo scan tools require Pro Cloud. Copy config from your dashboard or run init below.
npx prodverdict init --remote-mcp --project-id your-project-uuid{
"mcpServers": {
"prodverdict-remote": {
"url": "https://prodverdict.com/api/mcp",
"headers": {
"Authorization": "Bearer pv_...",
"X-Prodverdict-Project-Id": "your-project-uuid"
}
}
}
}Tools: validate_config, check_repo_contracts, check_boundary_contract, check_webhook_contract, suggest_fix, get_recent_runs. Prompts and schema resources included. Remote MCP docs