search

Searches all configured registries for matching MCP servers

Synopsis

Searches all configured registries for matching MCP servers, when name is not specified, the wildcard character (*) is used. Returns aggregated results from all configured registries

mcpd search [server-name] [flags]

Options

      --cache-dir string       Directory for caching registry manifests (default "/home/runner/.cache/mcpd/registries")
      --cache-ttl string       Time-to-live for cached registry manifests (e.g. 1h, 30m, 24h) (default "24h")
      --category stringArray   Optional, specify a partial match for required categories (can be repeated)
      --format format          Specify the output format (one of: json, text, yaml) (default text)
      --license string         Optional, specify a partial match for the license of the server (e.g. MIT, Apache)
      --no-cache               Disable registry manifest caching
      --official               Optional, only official server packages are included in results
      --refresh-cache          Force refresh of cached registry manifests
      --runtime string         Optional, specify the runtime of the server (e.g. uvx, npx)
      --source string          Optional, specify the source registry of the server (e.g. mozilla-ai)
      --tag stringArray        Optional, specify a partial match for required tags (can be repeated)
      --tool stringArray       Optional, specifies the tools the server must expose (can be repeated)
      --version string         Optional, specify the version of the server

Options inherited from parent commands

      --config-file string    path to config file (default ".mcpd.toml")
      --log-level string      log level for mcpd logs (default "info")
      --log-path string       log file path to use for log output
      --runtime-file string   path to runtime (execution context) file that contains env vars, and arguments for your MCP servers (default "/home/runner/.config/mcpd/secrets.dev.toml")

SEE ALSO

• mcpd - mcpd CLI is the primary interface for developers to interact with, and configure mcpd

Auto generated by spf13/cobra on 14-Aug-2026