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.

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.