Skip to main content

Server

mcpsmithy

Project-agnostic MCP tool server. Reads .mcpsmithy.yaml and serves MCP tools over stdio.

mcpsmithy <command> [flags]
FlagTypeDefaultDescription
-h, --helpboolShow context-sensitive help.
-c, --configstring.mcpsmithy.yamlPath to config file.
-l, --log-levelenum(debug,info,warn,error)infoLog level.

serve

Start the MCP server.

mcpsmithy serve [flags]
FlagTypeDefaultDescription
--transportenum(stdio,http)stdioTransport to use.
--addrstring:8080Listen address (HTTP transport only).
--watchboolfalseWatch config file and hot-reload on change.

validate

Validate config file.

mcpsmithy validate [flags]

sources

Manage sources.

mcpsmithy sources [flags]

sources pull

Fetch external sources and write them to disk.

mcpsmithy sources pull [flags]

setup

Start the config-authoring assistant (no config required).

mcpsmithy setup [flags]