Schema | mcp-nixos

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
`KEEP_TEST_CACHE`	No	Keep test cache directory for debugging (dev-only)	false
`ELASTICSEARCH_URL`	No	NixOS Elasticsearch API URL	https://search.nixos.org/backend
`MCP_NIXOS_LOG_FILE`	No	Where to document said failures
`MCP_NIXOS_CACHE_DIR`	No	Where to store stuff you'll forget about. Default: OS-specific cache locations
`MCP_NIXOS_CACHE_TTL`	No	How long until cache invalidation ruins your day (in seconds, 24h default)	86400
`MCP_NIXOS_LOG_LEVEL`	No	How much you want to know about your failures	INFO
`MCP_NIXOS_CLEANUP_ORPHANS`	No	Whether to kill orphaned MCP processes on startup	false

Schema

Prompts

Interactive templates invoked by user choice

Name	Description
`mcp_nixos_prompt`

Resources

Contextual data attached and managed by the client

Name	Description
`nixos://status`
`nixos://packages/stats`
`home-manager://status`
`home-manager://options/stats`
`home-manager://options/list`
`home-manager://options/programs`
`home-manager://options/services`
`home-manager://options/home`
`home-manager://options/accounts`
`home-manager://options/fonts`
`home-manager://options/gtk`
`home-manager://options/qt`
`home-manager://options/xdg`
`home-manager://options/wayland`
`home-manager://options/i18n`
`home-manager://options/manual`
`home-manager://options/news`
`home-manager://options/nix`
`home-manager://options/nixpkgs`
`home-manager://options/systemd`
`home-manager://options/targets`
`home-manager://options/dconf`
`home-manager://options/editorconfig`
`home-manager://options/lib`
`home-manager://options/launchd`
`home-manager://options/pam`
`home-manager://options/sops`
`home-manager://options/windowManager`
`home-manager://options/xresources`
`home-manager://options/xsession`
`darwin://status`
`darwin://options/stats`
`darwin://options/categories`

Tools

Functions exposed to the LLM to take actions

Name	Description
nixos_search	Search for NixOS packages, options, or programs. Args: query: The search term type: The type to search (packages, options, or programs) limit: Maximum number of results to return (default: 20) channel: NixOS channel to use (default: unstable) Returns: Results formatted as text
nixos_info	Get detailed information about a NixOS package or option. Args: name: The name of the package or option type: Either "package" or "option" channel: NixOS channel to use (default: unstable) Returns: Detailed information about the package or option
nixos_stats	Get statistics about available NixOS packages and options. Args: channel: NixOS channel to use (default: unstable) Returns: Statistics about packages and options
home_manager_search	Search for Home Manager options. Args: query: The search term limit: Maximum number of results to return (default: 20) Returns: Results formatted as text
home_manager_info	Get detailed information about a Home Manager option. Args: name: The name of the option Returns: Detailed information formatted as text
home_manager_stats	Get statistics about Home Manager options. Returns: Statistics about Home Manager options
home_manager_list_options	List all top-level Home Manager option categories. Returns: Formatted list of top-level option categories and their statistics
home_manager_options_by_prefix	Get all Home Manager options under a specific prefix. Args: option_prefix: The option prefix to search for (e.g., "programs", "programs.git") Returns: Formatted list of options under the given prefix
darwin_search	-
darwin_info	-
darwin_stats	-
darwin_list_options	-
darwin_options_by_prefix	-