run-mcpjam-evals

Runs, polls, and triages MCPJam hosted eval suites through MCP tools.

2.2k|272|Updated May 23, 2025
One-click install
npx skills add https://github.com/MCPJam/inspector --skill run-mcpjam-evals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-mcpjam-evals
Source: https://github.com/MCPJam/inspector/tree/main/skills/run-mcpjam-evals
Command: npx skills add https://github.com/MCPJam/inspector --skill run-mcpjam-evals

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Running hosted MCP eval suites involves cost-bearing launches, asynchronous polling, and multi-layer failure triage; this Skill defines the correct tool-call order and guardrails so runs are not double-billed, misread, or misdiagnosed.

Core Features & Use Cases

  • Cost-safe run lifecycle: Disclose what a run will do with get_eval_run_disclosure, launch asynchronously with run_eval_suite, and poll with get_eval_run until a terminal status.
  • Failure triage decision tree: Start from the verdict's decisionSummary and verdictSource, then drill into paginated iterations, per-step evidence, judge settings, gate waivers, or infrastructure diagnostics.
  • Regression comparison: Use compare_eval_run against a baseRunId or baseCommitSha to classify cases as regressed, fixed, new, or unchanged.
  • Use Case: After a server change, ask the agent to re-run a suite, confirm the billed scope first, poll to completion, and report which specific step failed with screenshot evidence.

Quick Start

Ask the agent to run the eval suite for your MCPJam project, disclose the cost first, and report which case and step caused any failure.

Frequently Asked Questions about run-mcpjam-evals

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an MCPJam eval suite and get the results?

Call run_eval_suite with the project to launch asynchronously and receive a runId, then poll get_eval_run until the status is completed, failed, or cancelled. Read the verdict from the run's decisionSummary before drilling into iterations.

How do I find out why an MCPJam eval run failed?

Start with get_eval_run's decisionSummary and verdictSource to identify what decided the outcome. Then use list_eval_run_iterations to find failing cases and get_eval_run_steps with the runId and iterationId to see the exact failed step and its evidence.

Which MCPJam eval tools cost money?

run_eval_suite and request_eval_run_judge spend the organization's model budget and are marked COSTS MONEY. Confirm the suite, case count, and iteration multiplier before the first call, and pass an idempotencyKey if a launch might be retried.

How do I compare two eval runs to check for regressions?

Use compare_eval_run with a baseRunId or baseCommitSha. It classifies each case as regressed, fixed, new_case, removed_case, changed, unchanged_passed, or unchanged_failed, which separates new breakage from pre-existing failures.

Why does my eval run show a pass rate that looks wrong?

list_eval_run_iterations is paginated, so a single page does not represent the whole run. Pass the returned nextCursor back as cursor until it is absent before computing any pass rate.

When should I use this instead of writing eval files locally?

Use this skill to run, investigate, or compare evals that already exist in an MCPJam project. To author eval files in a repo, use create-mcp-eval for SDK tests or mcpjam-eval-import to convert an existing corpus.