loading…
en/
Browse all
preflight
FreeMaintainedCheck if your MCP server is ready to publish on the MCP Registry, Smithery, or npm. Preflight validates your server's actual artifacts — `server.json`, `package
About
Check if your MCP server is ready to publish on the MCP Registry, Smithery, or npm. Preflight validates your server's actual artifacts — server.json, package.json, smithery.yaml — against the documented requirements of each directory. Every finding includes the evidence found, the directory rule it maps to, and the exact fix. ## What it checks - MCP Registry — server.json schema, name format, packages/remotes config, transport type, npm mcpName ownership, PyPI README marker - Smithery — Streamable HTTP transport, public HTTPS endpoint, server-card presence - npm — name, version, entry point (bin/main) Each finding is tagged with evidence level (verified_from_artifact or inferred), rule type (hard_requirement, directory_convention, or heuristic), and a source URL linking to the directory documentation. ## How to use Call check_publish_readiness with raw artifact contents (all fields optional): - manifest — your server.json - package_json — your package.json - smithery_yaml — your smithery.yaml - pyproject_toml — your pyproject.toml - readme — your README - target_directories — optional array of mcp_registry, smithery, npm Returns a verdict (checks_pass, fixable, or not_ready), per-directory readiness, and evidence-backed findings with concrete fixes. Zero dependencies. No LLM calls. No authentication. No PII collection.
README
Smithery CLI connects your agents to thousands of skills and MCP servers directly from the command line. To get started, simply run npx skills add smithery/cli.
Installation
npm install -g smithery@latest
Requires Node.js 20+.
Commands
MCP Servers
smithery mcp search [term] # Search the Smithery registry
smithery mcp add <url> # Add an MCP server connection
smithery mcp list # List your connections
smithery mcp remove <ids...> # Remove connections
Tools
Interact with tools from MCP servers connected via smithery mcp.
smithery tool list [connection] # List tools from your connected MCP servers
smithery tool find [query] # Search tools by name or intent
smithery tool get <connection> <tool> # Show full details for one tool
smithery tool call <connection> <tool> [args] # Call a tool
Skills
Browse skills on the Smithery Skills Registry and install them with the upstream installer:
npx skills add <skill> # e.g. npx skills add smithery-ai/cli
Auth
smithery auth login # Login with Smithery (OAuth)
smithery auth logout # Log out
smithery auth whoami # Check current user
smithery auth token # Mint a service token
smithery auth token --policy '<json>' # Mint a restricted token
Namespaces
smithery namespace list # List your namespaces
smithery namespace use <name> # Set current namespace
Publishing
smithery mcp publish <url> -n <org/server> # Publish an MCP server URL
smithery mcp publish <bundle.mcpb> -n <org/server> # Publish an MCP bundle
Examples
# Search and connect to an MCP server
smithery mcp search "github"
smithery mcp add github --id github
# Find and call tools from your connected MCP servers
smithery tool find "create issue"
smithery tool call github create_issue '{"title":"Bug fix","body":"..."}'
# Browse and install skills
smithery skill search "frontend" --json --page 2
smithery skill add anthropics/frontend-design --agent claude-code
# Publish your MCP server URL
smithery mcp publish https://my-mcp-server.com -n myorg/my-server
# Publish a built MCP bundle
smithery mcp publish ./server.mcpb -n myorg/my-server
Development
git clone https://github.com/smithery-ai/cli
cd cli && pnpm install && pnpm run build
npx . --help
Contributing
Contributions welcome! Please submit a Pull Request.
How to install
Run in your terminal:
claude mcp add preflight -- npx -y @smithery/cli run evan-follis-u0ll/preflightRelated MCPs
Compare preflight with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs