MCP Tool Reference

Available Tools

The RaidFrame MCP server exposes the following tools to AI assistants:

Deployment

rf_deploy

Deploy the current project.

Parameters:
  environment: string (optional) — "production", "staging", or custom
  watch: boolean (optional) — stream build logs
  branch: string (optional) — deploy specific branch

rf_rollback

Roll back to a previous deployment.

Parameters:
  deployment_id: string (optional) — specific deployment, defaults to previous
  environment: string (optional)

rf_deployments_list

List recent deployments.

Parameters:
  limit: number (optional, default: 10)
  environment: string (optional)

Services

rf_services_list

List all services in the project with status.

Returns: name, type, status, instances, cpu, memory for each service

rf_services_scale

Scale a service.

Parameters:
  service: string (required)
  min: number (optional)
  max: number (optional)
  resources: string (optional) — "starter", "standard", "pro", etc.

rf_services_restart

Restart a service.

Parameters:
  service: string (required)
  instance: string (optional) — specific instance ID

rf_services_info

Get detailed information about a service.

Parameters:
  service: string (required)

Databases

rf_db_add

Provision a new database.

Parameters:
  engine: string (required) — "postgres", "redis", "vector"
  name: string (optional)
  plan: string (optional)

rf_db_query

Run a SQL query against a database.

Parameters:
  database: string (required)
  query: string (required)

rf_db_info

Get database status, size, connections, and performance stats.

Parameters:
  database: string (required)

rf_db_backup

Create a database backup.

Parameters:
  database: string (required)
  name: string (optional)

Environment Variables

rf_env_list

List environment variables (values masked).

Parameters:
  environment: string (optional)

rf_env_set

Set one or more environment variables.

Parameters:
  variables: object (required) — {"KEY": "value", ...}
  environment: string (optional)

rf_env_get

Get a specific environment variable value.

Parameters:
  key: string (required)
  environment: string (optional)

rf_env_delete

Delete an environment variable.

Parameters:
  key: string (required)
  environment: string (optional)

Logs & Monitoring

rf_logs

Fetch logs from services.

Parameters:
  service: string (optional) — filter by service
  since: string (optional) — "1h", "30m", "2d"
  level: string (optional) — "error", "warn", "info"
  search: string (optional) — text search
  limit: number (optional, default: 100)

rf_metrics

Get current metrics for a service.

Parameters:
  service: string (optional)
  metric: string (optional) — specific metric name
  period: string (optional) — "1h", "24h", "7d"

rf_errors

List recent errors grouped by type.

Parameters:
  service: string (optional)
  since: string (optional)

rf_traces

Find distributed traces.

Parameters:
  service: string (optional)
  min_duration: string (optional) — "500ms", "1s"
  status: string (optional) — "error", "ok"
  limit: number (optional)

Domains

rf_domains_list

List all custom domains.

rf_domains_add

Add a custom domain.

Parameters:
  domain: string (required)
  environment: string (optional)

rf_domains_verify

Check DNS and SSL status for a domain.

Parameters:
  domain: string (required)

Cron & Jobs

rf_cron_list

List all cron jobs with next run time.

rf_cron_add

Create a cron job.

Parameters:
  schedule: string (required) — cron expression
  command: string (required)
  name: string (required)

rf_cron_run

Manually trigger a cron job.

Parameters:
  name: string (required)

Diagnostic

rf_doctor

Run a diagnostic check on the project.

Returns: CLI version, auth status, project config, service health, connectivity

rf_cost

Get current spending and forecast.

rf_resilience_report

Get infrastructure resilience score and recommendations.

SSH & Exec

rf_exec

Run a command in a service container.

Parameters:
  service: string (required)
  command: string (required)

rf_ssh

Open an interactive shell in a service container.

Parameters:
  service: string (required)
  instance: string (optional)