passmcp
Score a remote MCP server and verify attestations about it from inside your agent
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 0.0.8
- Listing updated
- today
Similar MCP servers
About passmcp
passmcp is an MCP server for developer tools. It runs locally on your machine and is started by your AI client.
passmcp is a diagnostic that tests an MCP server in nine phases, and this server exposes it as tools. Ask your agent to evaluate a server on a local port and it returns a score, a grade and each failing check with detail and a link to the fix.
It is read-only and allowlisted. Loopback addresses work out of the box and any other host must be named with --allow or the PASSMCP_SERVER_ALLOW variable, and it never sends a credential. The target must be a Streamable HTTP endpoint. A second tool checks a signed attestation, which needs only this server rather than the passmcp binary.
It is distributed as Go binaries for Linux, macOS and Windows, a go install route, and a distroless container image that bundles passmcp. Inside a container, loopback means the container itself, so host servers need host networking or host.docker.internal. It belongs to a family that includes a CI action, a graph tool and an LSP.
Install
Run in a terminal
claude mcp add passmcp-server -- docker run -i --rm ghcr.io/sebastienrousseau/passmcp-server:0.0.8Add to claude_desktop_config.json
{
"mcpServers": {
"passmcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/sebastienrousseau/passmcp-server:0.0.8"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"passmcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/sebastienrousseau/passmcp-server:0.0.8"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"passmcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/sebastienrousseau/passmcp-server:0.0.8"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"passmcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/sebastienrousseau/passmcp-server:0.0.8"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"passmcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/sebastienrousseau/passmcp-server:0.0.8"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PASSMCP_SERVER_ALLOWHosts passmcp_check may evaluate besides loopback, comma-separated; a leading dot allows subdomains. Inside the container, loopback is the container itself.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- passmcp_check
- Runs the passmcp diagnostic against a server URL and returns score, grade and failing checks.
- passmcp_verify_attestation
- Checks a passmcp attestation about a server.
What it does
- Server evaluation
- Returns score, grade and failing checks with fix links.
- Attestation check
- Verifies a signed attestation about a server.
- Allowlist
- Only loopback and named hosts can be tested.
- No credentials sent
- Evaluation never transmits secrets.
- Container image
- Distroless, non-root, amd64 and arm64.
Good for
- Fix failures in an MCP server you are building
- Check a vendor's server before connecting an agent
- Verify an attestation in an agent workflow
passmcp FAQ
What must be installed?
passmcp must be on PATH for the check tool; the container image includes it.
Can it test any URL?
No, only loopback or hosts you allowlist, and only Streamable HTTP.
Does it change anything?
No, it is read-only.
How do I add passmcp to Claude Code?
Run this command in your terminal: claude mcp add passmcp-server -- docker run -i --rm ghcr.io/sebastienrousseau/passmcp-server:0.0.8
What are the best alternatives to passmcp?
The closest alternatives to passmcp are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


