Skip to content
MCP server

Mcpreflight

Read-only preflight checks for MCP and x402 endpoints before an agent depends on them

Runs locallyStatus and history
Install
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/mcpreflight

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcpreflight": {
      "command": "npx",
      "args": [
        "-y",
        "@eidonze/mcpreflight"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcpreflight": {
      "command": "npx",
      "args": [
        "-y",
        "@eidonze/mcpreflight"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools