Mcpreflight
Read-only preflight checks for MCP and x402 endpoints before an agent depends on them
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.6.2
- Listing updated
- 3 days ago
About Mcpreflight
Mcpreflight is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
mcpreflight answers one question about a deployed endpoint: will it answer an agent, and does its payment challenge still hold? It runs the MCP initialize handshake and tools/list validation, or inspects an HTTP 402 / x402 payment document, using only what the endpoint sends to any anonymous caller. It never invokes tools, accepts credentials or makes payments, and its docs say PASS is an observed-check result, not a security certification or trust score.
The CLI prints PASS, FAIL or UNKNOWN with exit codes 0, 1 and 2 so CI can gate on it, and a GitHub Action fails a pull request when a handshake, tool schema or x402 challenge drifts. In MCP server mode it exposes schema_check and x402_inspect so an agent can vet an endpoint before connecting.
The project also publishes a weekly sweep of the official MCP Registry. As of 2026-11-09 it reported 35,327 remote endpoints, 20,672 PASS (58.5%), 151 FAIL and 14,504 with no anonymous handshake, with per-endpoint reports and JSON APIs in its Trust Directory.
Install
Run in a terminal
claude mcp add mcpreflight -- npx -y @eidonze/mcpreflightAdd to claude_desktop_config.json
{
"mcpServers": {
"mcpreflight": {
"command": "npx",
"args": [
"-y",
"@eidonze/mcpreflight"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcpreflight": {
"command": "npx",
"args": [
"-y",
"@eidonze/mcpreflight"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcpreflight": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@eidonze/mcpreflight"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcpreflight": {
"command": "npx",
"args": [
"-y",
"@eidonze/mcpreflight"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcpreflight": {
"command": "npx",
"args": [
"-y",
"@eidonze/mcpreflight"
]
}
}
}Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- schema_check
- Runs the initialize and tools/list checks on an endpoint.
- x402_inspect
- Inspects an endpoint's HTTP 402 payment challenge without paying.
What it does
- Handshake and schema check
- Validates initialize and tools/list, including tool schemas and required fields.
- x402 inspector
- Reads 402 challenge shape, accepts[] and discovery manifests without paying.
- CI-friendly exit codes
- Exit 0, 1 or 2 maps to PASS, FAIL or UNKNOWN.
- GitHub Action
- Fails a pull request when an endpoint drifts.
- Trust Directory
- Weekly per-server reports and JSON APIs for registry endpoints.
- Strictly read-only
- No tool calls, credentials, wallets or payments.
Good for
- Test a remote MCP server before connecting an agent
- Gate a pull request on an endpoint still passing
- Watch an x402 payment challenge for drift
- Look up the weekly status of a registry server
Pricing
Open source
Free; browser check needs no signup
Prices change. Check xka0085-byte.github.io before you buy.
Mcpreflight FAQ
Does it call my tools?
No. It reads only the handshake, tools/list and the 402 payment document.
How do I run it?
npx -y @eidonze/mcpreflight schema <url>, or via Homebrew, the GitHub Action or the stdio server.
Is PASS a security audit?
No. It is a deterministic result of the checks in that version, not a certification or trust score.
How are authenticated endpoints counted?
As AUTH_GATED rather than failures.
Is Mcpreflight free?
Yes. Mcpreflight is open source, so you can use and self-host it for free.
How do I add Mcpreflight to Claude Code?
Run this command in your terminal: claude mcp add mcpreflight -- npx -y @eidonze/mcpreflight
What are the best alternatives to Mcpreflight?
The closest alternatives to Mcpreflight are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Mcpreflight

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools