Skip to content
MCP server

passmcp

Score a remote MCP server and verify attestations about it from inside your agent

Runs locallyStatus and history
Install
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.8

Add to claude_desktop_config.json

{
  "mcpServers": {
    "passmcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/sebastienrousseau/passmcp-server:0.0.8"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "passmcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/sebastienrousseau/passmcp-server:0.0.8"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers