forge-test-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| root | No | Project directory (default: where the client starts the server). Passed as `--root <dir>`. | |
| forge | No | The `forge` executable (default: `forge` on `PATH`). Passed as `--forge <path>`. | |
| timeout | No | Stop a forge run after this many seconds (default 300). Passed as `--timeout <seconds>`. | 300 |
| allow-ffi | No | Let tests use FFI cheatcodes when `foundry.toml` enables them. Off by default. Passed as `--allow-ffi`. | false |
| strict-version | No | Refuse forge versions newer than the tested range instead of flagging them. Passed as `--strict-version`. | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| run_testsA | Run |
| explain_failureA | Re-run one test at high verbosity and return only that test: its reason, decoded call trace (trimmed to the path to the revert when long), backtrace, logs and, for fuzz or invariant tests, the counterexample. Pass the test name as run_tests reports it, e.g. "BankTest.test_transfer()". |
| buildA | Compile the project with |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 3 tools
run_tests, explain_failure, and build have clearly distinct purposes: one runs the suite, one drills into a single failure at high verbosity, one compiles. An agent can easily route each request.
run_tests and explain_failure follow verb_noun, while build is a bare verb. Minor deviation but still readable and predictable.
Three tools is slightly thin but each earns its place covering the core workflow of build, run, and diagnose. Well-scoped for a focused Foundry testing server.
The build-run-explain lifecycle is fully covered, including structured compiler output and fuzz/invariant counterexamples. Minor gaps like listing tests or coverage exist but core workflows are complete.