MCP tool reference

One connection. Scoped access.

Connect to https://app.helicarrier.xyz/mcp using Streamable HTTP. Start with whoami to discover your key’s scope. Visible tools and permitted actions depend on your credentials.

Connect an MCP client

Find a tool70 tools

Identity & plans

whoamiRead

Identify the authenticated caller and discover the resources and permissions available to a scoped key.

Required: None

list_plansRead

Discover the available service and database plans before creating or resizing a resource.

Required: None

Projects & environments

list_projectsRead

List projects visible to your account, including their service counts and environment summaries.

Required: None

get_projectRead

Read a project and its services in one environment. Select an environment explicitly when automating a workflow.

Required: slug

list_deleted_servicesRead

Find services in a project that are still eligible for restoration.

Required: slug

create_projectWrite

Create a project to organize related services and environments.

Required: name

list_environmentsRead

List environments visible to the caller within a project.

Required: projectSlug

Services & configuration

get_serviceRead

Read a service’s current state, source configuration, plan, and exposed ports.

Required: id

get_scalingRead

Read the instance floor, autoscaling ceiling, and effective service capacity.

Required: id

get_dependenciesRead

Inspect dependency issues that can prevent a service from starting correctly.

Required: id

create_serviceWrite

Create a service from a Git repository or container image. Creation queues a deployment and starts a billed resource.

Required: name, projectSlug

update_build_settingsWrite

Update the build directory, builder, and build or runtime commands for a service.

Required: id

set_readonly_filesystemWrite

Configure a read-only root filesystem for the service’s next deployment.

Required: id, readonlyRootfs

scale_serviceWrite

Set the service’s instance count and, optionally, its autoscaling targets and ceiling.

Required: id

stop_serviceWrite

Stop a running service. Deploy it again when you are ready to resume.

Required: id

delete_serviceWrite

Delete a service and place eligible resources within the restoration window.

Required: id

restore_serviceWrite

Restore an eligible deleted service and redeploy it with its retained configuration.

Required: id

set_service_imageWrite

Change a service’s container image and optionally deploy it immediately.

Required: id, image

set_planWrite

Move a service to another available compute plan.

Required: id, planKey

Deployments

list_deploymentsRead

Read deployment history for a service, newest first, with rollback eligibility and a pagination cursor.

Required: id

deploy_serviceWrite

Queue a deployment for an existing service. For a Git service, optionally select a one-off branch, tag, or commit.

Required: id

deploy_uploadWrite

Create a new service from a base64-encoded source archive. Use reupload to update an existing upload service.

Required: projectSlug, name, archiveBase64

reupload_serviceWrite

Deploy a new source archive to an existing upload service while keeping its identity and configuration.

Required: id, archiveBase64

rollback_serviceWrite

Queue a deployment using a retained image from an earlier release.

Required: id, deploymentId

abort_deployWrite

Request cancellation of a deployment that is still in progress.

Required: deploymentId

set_autodeployWrite

Enable or disable automatic deployments when the tracked Git source changes.

Required: id, enabled

create_deploy_triggerWrite

Create or rotate a secret URL that can trigger deployments. The token is shown only once.

Required: id

delete_deploy_triggerWrite

Revoke the service’s current deploy-trigger URL.

Required: id

Logs & metrics

get_logsRead

Read runtime output from a service. Filter historical logs or read incrementally with a cursor.

Required: id

get_metricsRead

Read service resource usage over a supported time window.

Required: id

get_deployment_logsRead

Read build and deployment output, optionally after a previously seen log identifier.

Required: deploymentId

Variables & references

list_envRead

List environment variable names and masked values for a service.

Required: id

set_envWrite

Create or update one environment variable. The running service receives it on its next deployment.

Required: id, key, value

list_referencesRead

List environment-variable references connecting this service to provider services.

Required: id

list_env_groupsRead

Discover shared environment groups owned by your account.

Required: None

delete_envWrite

Delete an environment variable from a service’s saved configuration.

Required: id, key

add_referenceWrite

Inject a value from a provider service into a consumer’s environment variable.

Required: id, providerId

Domains & networking

list_domainsRead

List the custom domains attached to a service and their current verification state.

Required: id

list_portsRead

Inspect a service’s primary HTTP port, additional exposed ports, and detected port suggestions.

Required: id

get_dns_targetRead

Get the DNS target to use when connecting a custom domain to this service.

Required: id

list_dedicated_ipsRead

List dedicated outbound addresses held by your account and their attachments.

Required: None

get_project_dedicated_ipRead

Read the outbound IP attachment inherited by eligible services in this project.

Required: slug

attach_project_dedicated_ipWrite

Attach an existing account-owned outbound IP to a project.

Required: slug, ipId

detach_project_dedicated_ipWrite

Detach an outbound IP from a project without releasing the purchased address.

Required: slug

get_service_dedicated_ipRead

Read a service’s explicit outbound IP and its project-level fallback.

Required: id

attach_service_dedicated_ipWrite

Attach an existing account-owned outbound IP to a service. A deployment is required to apply it.

Required: id, ipId

detach_service_dedicated_ipWrite

Remove a service’s outbound IP override without releasing the address.

Required: id

add_domainWrite

Attach a custom domain to a service, then configure DNS to complete verification.

Required: id, hostname

import_envWrite

Import several environment variables into a service in one request.

Required: id, vars

expose_portWrite

Expose an additional HTTP port and create a generated hostname for it.

Required: id, port, label

remove_portWrite

Remove an additional exposed HTTP port and its generated route.

Required: id, port

remove_domainWrite

Remove a custom domain from this service.

Required: id, domainId

set_search_indexingWrite

Control search-indexing headers on a service’s generated hostname.

Required: id, enabled

Databases & storage

list_enginesRead

Discover supported database engines, versions, and provisioning capabilities.

Required: None

list_db_extensionsRead

Read the curated PostgreSQL extension catalog available during database creation.

Required: None

get_db_metricsRead

Read engine-specific database metrics, grouped for inspection.

Required: id

set_storageWrite

Change the provisioned storage of a managed database or bucket without changing its compute plan.

Required: id, storageGb

create_databaseWrite

Provision a managed database in a project and environment using a supported engine and plan.

Required: name, engine

get_db_connectionRead

Read connection details and credentials for a database you can access. Treat this response as a secret.

Required: id

list_backupsRead

List the backup records for a managed database.

Required: id

create_backupWrite

Start an on-demand backup of a managed database.

Required: id

restore_backupWrite

Restore a selected backup into its database. This overwrites the current database contents.

Required: id, backupId

db_queryWrite

Run a SQL query against a managed database. Queries can modify data; inspect the response for execution errors.

Required: id, query

rotate_db_credentialsWrite

Change a managed database’s password and invalidate the previous credential.

Required: id, password

set_db_external_accessWrite

Enable or disable external connections for a supported database.

Required: id, external

set_db_allowlistWrite

Set the source CIDRs allowed to connect to an externally accessible database.

Required: id, allowIps

set_db_tlsWrite

Enable or disable external TLS for a supported database.

Required: id, tls

Scheduled jobs

get_cronRead

Read a cron service’s schedule, command, and next expected run.

Required: id

run_cronWrite

Queue an immediate run of a cron service without changing its schedule.

Required: id

update_cronWrite

Update a cron service’s schedule or command.

Required: id, schedule

MCP calls use the same resource and permission checks as REST requests.

Understand key scope