> ## Documentation Index > Fetch the complete documentation index at: https://docs.valkyrieapp.azumo.com/llms.txt > Use this file to discover all available pages before exploring further. # MCP tools reference > Every tool the Valkyrie MCP server exposes, grouped by area, with what each one does. The Valkyrie MCP server exposes the tools below, grouped by area. Tool names and availability evolve, so **your client's live tool list is always the source of truth**, use this page to understand what each does. Tools marked **⚠ mutating** change real resources. Some spend from your wallet or tear down running infrastructure, and act on whatever environment your key points at. There is no dry-run or undo for a terminate. See [what it can't do](/mcp/overview). ## Server | Tool | What it does | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `server_info` | Server information and your authentication status. Note: "configured" only means a key was *supplied*, call a data tool like `list_deployments` to confirm it's *valid*. | ## Deployments, inspect | Tool | What it does | | ------------------------- | ------------------------------------------------------------- | | `list_deployments` | List your model deployments and their status. | | `get_deployment_status` | Detailed status for one deployment: state, health, endpoint. | | `check_deployment_health` | Actively health-check a deployment's model. | | `check_service_health` | Check the underlying serving service (engine/process) health. | ## Deployments, create & lifecycle | Tool | What it does | | ---------------------------- | ---------------------------------------------------------------------------------------------------------------- | | `deploy_base_model` | **⚠ mutating** Deploy any Hugging Face base model to a new serving endpoint. | | `deploy_fine_tuned_model` | **⚠ mutating** Deploy a completed fine-tuning job's model. | | `start_model_service` | **⚠ mutating** Start the serving process on a deployment. | | `restart_model_service` | **⚠ mutating** Restart just the serving process (no redeploy). | | `restart_deployment` | **⚠ mutating** Restart the whole deployment. | | `stop_deployment` | **⚠ mutating** Stop a deployment and release its GPU. | | `pause_deployment` | **⚠ mutating** Pause a deployment. | | `resume_deployment` | **⚠ mutating** Resume a paused/stopped deployment (re-provisions a GPU). | | `recover_failed_deployment` | **⚠ mutating** Attempt to recover a deployment stuck in a failed state. | | `resync_deployment_instance` | Re-sync a deployment's record with its actual cloud instance. | | `execute_tool` | Run a deployed model (`deployment-{id}`) or the fine-tune control plane (`fine-tuning` / `fine-tuned-{job_id}`). | ## Deployments, schedules & auto-recovery | Tool | What it does | | ------------------------------------- | ----------------------------------------------------------------- | | `get_deployment_schedules` | List schedules configured for a deployment. | | `set_deployment_schedule` | **⚠ mutating** Set a custom cron start/stop schedule. | | `configure_deployment_12h_schedule` | **⚠ mutating** Apply a preset 12-hour uptime schedule. | | `configure_deployment_auto_restart` | **⚠ mutating** Enable/configure automatic restart when unhealthy. | | `set_deployment_scheduled_stop` | **⚠ mutating** Schedule a one-off stop. | | `clear_deployment_scheduled_stop` | **⚠ mutating** Clear a scheduled stop. | | `set_deployment_scheduled_restart` | **⚠ mutating** Schedule a one-off restart. | | `clear_deployment_scheduled_restart` | **⚠ mutating** Clear a scheduled restart. | | `toggle_deployment_schedule` | **⚠ mutating** Enable or disable a schedule. | | `trigger_deployment_schedule` | **⚠ mutating** Run a schedule's action immediately. | | `delete_deployment_schedule` | **⚠ mutating** Delete a schedule. | | `list_deployment_schedule_executions` | List a schedule's past executions. | ## Fine-tuning, jobs | Tool | What it does | | ------------------------- | ------------------------------------------------------------ | | `list_fine_tuning_jobs` | List your fine-tuning jobs. | | `get_fine_tuning_job` | One job's details and status. | | `create_fine_tuning_job` | **⚠ mutating** Create and launch a new fine-tuning job. | | `retry_fine_tuning_job` | **⚠ mutating** Retry a job (reschedule onto fresh hardware). | | `cancel_fine_tuning_job` | **⚠ mutating** Cancel a running or pending job. | | `recover_failed_job` | **⚠ mutating** Recover a job stuck in a failed state. | | `list_fine_tuning_models` | List models produced by completed jobs. | | `terminate_cluster` | **⚠ mutating** Terminate the GPU cluster backing a job. | ## Fine-tuning, outputs | Tool | What it does | | -------------------------------- | ---------------------------------------- | | `get_job_outputs` | List a completed job's output artifacts. | | `download_job_outputs` | Download outputs (convenience wrapper). | | `plan_job_output_download` | Plan a (possibly large) output download. | | `start_job_output_download` | Start a planned download. | | `get_job_output_download_status` | Check download progress. | | `get_job_output_download_urls` | Get signed URLs for a job's outputs. | ## Datasets | Tool | What it does | | ------------------------ | ---------------------------------------- | | `list_datasets` | List your datasets. | | `get_dataset` | Get a dataset's info. | | `get_dataset_upload_url` | Get a presigned URL to upload a dataset. | | `download_dataset` | Get a signed URL to download a dataset. | | `delete_dataset` | **⚠ mutating** Delete a dataset. | ## Cloud & GPUs | Tool | What it does | | ----------------------------- | ----------------------------------------------------------------- | | `get_cloud_account_status` | Status of the connected GPU-marketplace account(s). | | `get_cloud_account_balances` | Marketplace account balances. | | `get_cloud_running_instances` | List currently running cloud instances. | | `sync_cloud_state` | Reconcile Valkyrie's records with the marketplace's actual state. | | `stop_vast_instance` | **⚠ mutating** Stop a specific Vast.ai instance. | | `adopt_orphaned_instances` | **⚠ mutating** Adopt running instances that lost their DB link. | | `get_gpu_availability` | Check available GPU types and capacity. | | `check_gpu_for_deployment` | Check whether a specific GPU is available for a deployment. | ## Logs All log tools return **GPU-workload and deployment output**, not Valkyrie's own internal application logs. | Tool | What it does | | ----------------------- | ------------------------------------------ | | `get_job_logs` | A fine-tuning job's logs. | | `get_deployment_logs` | A deployment's logs. | | `get_vllm_service_logs` | The vLLM serving engine's logs. | | `get_persisted_logs` | DB-persisted logs for a job or deployment. | | `collect_logs_now` | Force an immediate log collection. | ## Inference pools Pool administration manages configuration and leases only, it **never provisions or mutates model-serving deployments**. | Tool | What it does | | ------------------------------- | ---------------------------------------------------------- | | `list_inference_pools` | List pools you're authorized for. | | `get_inference_pool` | One pool's configuration and capacity. | | `create_inference_pool` | **⚠ mutating** Create a pool. | | `update_inference_pool` | **⚠ mutating** Update pool configuration/state. | | `replace_inference_pool_member` | **⚠ mutating** Apply an explicit member lease disposition. | | `delete_inference_pool` | **⚠ mutating** Delete a pool. |