This section documents each tool available in the Ludus MCP Server. Tools are organized by category for easy reference.

Create and save range configuration files from YAML content.

Read configuration files from local filesystem or remote URLs.

Validate range configurations against official Ludus schemas.

List and analyze available configuration templates.

Apply a configuration to Ludus server for deployment.

Retrieve current configuration from Ludus server.

Deploy configured ranges to Ludus infrastructure.

Remove deployed ranges and clean up resources.

Check deployment status and health of ranges.

List ranges for specific users or all users.

Get detailed information about user ranges.

List all users on the Ludus server.

Read role and collection schemas for configuration building.

List available schema files and their metadata.

Access documentation for Ludus roles and collections.

Read networking configuration documentation.

Search environment-specific setup guides.

Execute raw Ludus CLI commands with safety checks.

Get help information for Ludus CLI commands.

Manage VM power states (start, stop, reboot).

Get intelligent planning assistance for range creation.

Retrieve stored credentials from system keyring.

Insert credentials into range configurations.

Validate configurations against planning requirements.

Read the official range configuration schema.

Configuration Management Tools for creating, reading, and managing range configuration files.

Range Operations Tools for deploying, monitoring, and destroying ranges on Ludus servers.

Information and Documentation Tools for accessing schemas, documentation, and help information.

System Integration Tools for direct CLI access and system-level operations.

Security and Credentials Tools for managing authentication and credential injection.

Configuration Workflow

1. Use schema tools to understand available roles
2. Create configurations with write tools
3. Validate before deployment
4. Deploy and monitor status

Operational Workflow

1. Check current status
2. Set configurations
3. Deploy ranges
4. Monitor and manage

Research Workflow

1. List available schemas and templates
2. Read documentation for specific roles
3. Plan configuration requirements
4. Build and test configurations

Each tool page includes detailed usage examples, parameter descriptions, and common use cases.