# Crucible > Crucible runs a repository's tests in a fresh Firecracker microVM per run, on a warm base of the repo, and answers with one JSON result an AI coding agent can act on. Agents use the hosted MCP server, https://mcp.crucibl.sh/mcp, or the `crucible` CLI. To set up Crucible for a repo, follow https://crucibl.sh/agents.md. ## Docs - [Set up Crucible for this repo](https://crucibl.sh/agents.md): The runbook an agent follows to connect Crucible to a GitHub repo and reach a first green run: one prompt, one browser visit for the human. - [Crucible quickstart](https://crucibl.sh/docs/quickstart.md): Crucible runs a repo's tests in a fresh Firecracker microVM per run, on a warm base of the repo, and answers with one JSON result an agent can act on. Start here. - [Clients](https://crucibl.sh/docs/clients.md): How each agent client adds the hosted Crucible MCP server, signs in, and finds the skill; plus permissions and keys for headless agents. - [The hosted MCP server](https://crucibl.sh/docs/mcp.md): The tools of https://mcp.crucibl.sh/mcp: arguments, answers, waiting and polling, sign-in. - [Results](https://crucibl.sh/docs/results.md): Every field of a Crucible test result, as `run_tests`, `get_job` and `crucible test` return it, and what to do with each status. - [Refusals and what to do](https://crucibl.sh/docs/reasons.md): Every `rejected: ` reason Crucible answers, its CLI exit code, and the fix; plus sign-in, key and setup failures. - [Detection and .crucible.toml](https://crucibl.sh/docs/config.md): How Crucible finds a repo's tests with no config, what the test VM can reach, and every `.crucible.toml` key. - [GitHub Actions runners](https://crucibl.sh/docs/actions.md): Run GitHub Actions jobs on Crucible microVMs with `runs-on: crucible-2vcpu-arm` (or `crucible-2vcpu-x64`): labels, setup, what works, limits and prices. - [Set up and speed up CI](https://crucibl.sh/docs/ci-setup.md): Decide how a repo's CI uses Crucible (its own PR check or Actions on Crucible runners), measure its GitHub Actions runs with `ci_report`, and cut minutes with small, measured pull requests. - [The crucible CLI](https://crucibl.sh/docs/cli.md): Install, log in, run the working tree's tests, read jobs, exit codes, and the CLI's local MCP server. - [The GitHub page](https://crucibl.sh/docs/github.md): What https://crucibl.sh/github sets for each repo, and how forks, required checks and runner groups work. ## Skill - [The crucible skill](https://crucibl.sh/skills/crucible/SKILL.md): Run a repository's tests on Crucible (crucibl.sh) microVMs and act on the results. Use when asked to run the tests, check that a change passes, rerun failing tests, find out why CI or a PR check (`Crucible`) is red, handle flaky or quarantined tests, shard a slow suite, set up Crucible for a repo, make its CI faster or cheaper, or move GitHub Actions jobs onto Crucible runners (runs-on crucible-2vcpu-arm). Covers the hosted Crucible MCP server (run_tests, get_job, status, get_pr_check, actions_setup, ci_report, set_repo_ci) and the `crucible` CLI. - [As AGENTS.md](https://crucibl.sh/skills/AGENTS.md): the skill as one section for agents that read only AGENTS.md - [As a Cursor rule](https://crucibl.sh/skills/crucible.mdc): the skill as .cursor/rules/crucible.mdc ## Optional - [Everything in one file](https://crucibl.sh/llms-full.txt): every page above, and the skill - [Terms](https://crucibl.sh/terms), [privacy](https://crucibl.sh/privacy), [refunds](https://crucibl.sh/refunds)