Browse documentation
← MCP reference

MCP tool

tests_check

Run the local test check for committed inputs. The version-1 report or problem is in structuredContent, with a summary in text. A passing check can still have findings to review. Recognised comment-only and docstring-only hunks may be left out. Without an account, the check does not run and reports failure. A focused recheck uses installed machine state unless isolated. Use tests_accept to record an agent acceptance when the policy allows.

CLI 0.2.11

Examples

Check the committed change and read the version-1 report in structuredContent, including findings when the check passes. A missing account reports that the check did not run.

{
  "arguments": {
    "base": "origin/main",
    "head": "HEAD"
  },
  "name": "tests_check"
}

Input schema

baseoptional · string

Target branch to compare the change against.

base_commitoptional · string

Use this commit as the comparison base instead of finding a merge base.

budget_secondsoptional · integer

Optional time budget for the entire check in seconds.

Minimum: 1

findingoptional · string

Recheck only this finding from a saved full check. A focused recheck doesn't stand in for a full check.

headoptional · string

Commit to check; defaults to HEAD.

isolatedoptional · boolean

Run without copying the checkout's installed state.

jobsoptional · integer

Request workers up to CPUs minus one. Automatic selection considers memory and Cargo build jobs. Free disk, shared fixtures and the local copy can reduce concurrency, with a notice.

Minimum: 1

run_timeout_secondsoptional · integer

Optional fixed invocation deadline. Controls are unlimited by default; experiments use measured build and test times with one longer timeout retry.

Minimum: 1

show_requestsoptional · boolean

Include scrubbed model requests and prompts in the tool result.

JSON Schema
{
  "additionalProperties": false,
  "examples": [
    {
      "base": "origin/main",
      "head": "HEAD"
    }
  ],
  "properties": {
    "base": {
      "description": "Target branch to compare the change against.",
      "type": "string"
    },
    "base_commit": {
      "description": "Use this commit as the comparison base instead of finding a merge base.",
      "type": "string"
    },
    "budget_seconds": {
      "description": "Optional time budget for the entire check in seconds.",
      "minimum": 1,
      "type": "integer"
    },
    "finding": {
      "description": "Recheck only this finding from a saved full check. A focused recheck doesn't stand in for a full check.",
      "type": "string"
    },
    "head": {
      "default": "HEAD",
      "description": "Commit to check; defaults to HEAD.",
      "type": "string"
    },
    "isolated": {
      "description": "Run without copying the checkout's installed state.",
      "type": "boolean"
    },
    "jobs": {
      "description": "Request workers up to CPUs minus one. Automatic selection considers memory and Cargo build jobs. Free disk, shared fixtures and the local copy can reduce concurrency, with a notice.",
      "minimum": 1,
      "type": "integer"
    },
    "run_timeout_seconds": {
      "description": "Optional fixed invocation deadline. Controls are unlimited by default; experiments use measured build and test times with one longer timeout retry.",
      "minimum": 1,
      "type": "integer"
    },
    "show_requests": {
      "description": "Include scrubbed model requests and prompts in the tool result.",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

Related command: cscale tests.