Railway for AI agents

Agents read Railway at once. Changes and sends are held for a person's approval by default.

About Railway

Railway is a deployment platform for building and shipping applications with instant deployments, automatic scaling, and managed infrastructure.

What an agent can do in Railway

Every Railway action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.

Runs at once (reads)

Looks things up in Railway without asking first. 26 actions.

  • Collect Deployment EvidenceCollect a bounded, best-effort Railway deployment evidence bundle from live-validated deployment, snapshot, event, service-instance, log, and metric sources. Results may be partial and report complete
  • Get Build LogsReturn a bounded, optionally filtered time window of build-phase logs for one Railway deployment.
  • Get DeploymentReturn one deployment's status, timestamps, metadata, and rollback eligibility.
  • Get Deployment LogsRetrieve runtime logs for a deployment. Use when you need to view the runtime application logs for troubleshooting runtime issues, monitoring application behavior, or debugging errors that occur durin
  • Get EnvironmentGet details of a specific Railway environment by its ID, including service instances and deployment information. Use this action when you need to retrieve detailed information about an environment, su
  • Get GitHub PR InfoGet information for a GitHub pull request associated with a Railway service. Use this action when you need to retrieve details about a specific pull request, such as its title, state, URL, or author i
  • Get HTTP LogsReturn a bounded date-anchor window of HTTP request logs for one deployment, including request, response, timing, and routing fields.
  • Get HTTP MetricsReturn either HTTP request counts grouped by status code or p50/p90/p95/p99 response-time series for one Railway service and environment. Status counts are returned as evidence and are not converted i
  • Get Resource MetricsReturn sampled CPU, memory, disk, network, backup, or volume measurements for selected Railway resources and time range.
  • Get TemplateReturn a Railway template's ID, name, and serialized configuration required for deterministic deployment.
  • Get User Kickback EarningsGet the total kickback earnings for the authenticated Railway user. Use this action when you need to retrieve the kickback earnings information for the authenticated user, including the total amount e
  • List API TokensRetrieve all API tokens for the authenticated user from Railway. Use this action when you need to fetch the list of API tokens associated with the currently authenticated user. This is a read-only ope
Show all 26
  • List DeploymentsList one page of Railway deployments filtered by project, environment, service, status, or deletion state.
  • List DomainsList Railway and custom domains for a service, including IDs, ports, DNS records, certificate state, and custom-domain verification token.
  • List Environment PatchesRetrieve all patches for a Railway environment using the GraphQL API. Use this action when you need to fetch the list of configuration patches applied to an environment. This is useful for auditing en
  • List EnvironmentsList one page of project environments with IDs, pull-request metadata, source environment, and staged-change count.
  • List GitHub ReposRetrieve a list of GitHub repositories that Railway has access to. Use this action when you need to fetch the list of GitHub repositories associated with the authenticated user's GitHub account throug
  • List GitHub Writable ScopesRetrieve the list of GitHub scopes the user has installed the installation to. Use this action when you need to fetch the list of GitHub scope names that the authenticated user has granted to the Rail
  • List Integration AuthsRetrieve all integration auths for the authenticated user from Railway. Use this action when you need to fetch the list of integration auths (such as GitHub, GitLab, Vercel, or other connected integra
  • List Notification DeliveriesRetrieve notification deliveries for the authenticated user. Use this action when you need to fetch a list of notification deliveries, such as tracking which notifications have been sent (e.g., EMAIL,
  • List ProjectsList one page of projects in an accessible Railway workspace with project and workspace identifiers. Use LIST_SERVICES and LIST_ENVIRONMENTS for those independently paginated resources.
  • List ServicesList one page of service IDs and names in a project for service, deployment, logs, metrics, domain, and volume tools.
  • List Railway Trusted DomainsFetch all trusted domains for the authenticated Railway workspace. Use this action when you need to retrieve all trusted domains configured for workspace membership invitations. Trusted domains allow
  • List VariablesReturn Railway shared-environment or service variables. Choose stored to preserve or render references, or deployment_resolved to return the values supplied to a specific service deployment. Variable
  • List VolumesList one page of persistent volume IDs and names in a project for storage configuration and metrics workflows.
  • Search TemplatesSearch one cursor-controlled page of Railway templates by text, verification state, and category.

Held for approval by default (changes and sends)

Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 31 actions.

  • Cancel DeploymentCancel a Railway deployment that is queued or building, preventing that in-progress deployment from completing. This does not stop a running deployment and requires confirm=true.
  • Commit Environment ChangesCommit existing staged changes for a Railway environment, completing a staged STAGE_TEMPLATE or create-environment workflow. This irreversible update can start deployments unless skip_deploys=true and
  • Configure Buckets and Private NetworkCommit an explicit Railway patch for bucket creation, updates, or deletion and the environment private-network enabled state. Existing staged changes are not committed or replaced, and this tool does
  • Create DomainCreate either a generated railway.app domain or a caller-owned custom domain. Custom-domain responses include every DNS setup record plus Railway's verification token and state.
  • Create EnvironmentCreate an empty Railway environment or clone an existing environment, with explicit initial-deployment and change-staging behavior.
  • Create PluginCreates a new plugin in Railway for the specified project. Use this action when you need to add a custom plugin to a Railway project, such as for integrating external services or extending project fun
  • Create ProjectCreate a Railway project in an accessible workspace and return its project and default-environment IDs. Optionally connect a repository branch for deployment and configure the runtime, public visibili
  • Create ServiceCreate an empty, repository-backed, image-backed, or template-backed service in a Railway project.
  • Create VolumeCreate a persistent Railway volume and optionally attach it to one service and environment. This action creates billable persistent state and does not clean it up; deletion is a separate DELETE_VOLUME
  • Delete DeploymentPermanently delete a completed Railway deployment from deployment history and stop any remaining project usage from it. This does not delete the service, is irreversible, and requires confirm=true.
  • Delete DomainPermanently delete one generated Railway domain or custom domain by ID after explicit confirmation.
  • Delete EnvironmentPermanently delete one Railway environment and its deployments. This action is irreversible, requires confirm=true, and requires workspace-admin authorization when using OAuth. Reconnect with a separa
Show all 31
  • Delete VariableDelete a Railway environment variable. This action uses the `variableDelete` GraphQL mutation to permanently remove an environment variable from a project, environment, or service. This action is irre
  • Delete VolumePermanently delete a persistent volume and all its associated data from Railway. Use when you need to remove a volume that is no longer needed. This action is irreversible — the volume and all its dat
  • Delete workspaceDelete a Railway workspace and all data associated with it. This action uses the `workspaceDelete` GraphQL mutation to permanently remove a workspace. Use this action when you need to permanently dele
  • Deploy ServiceStart a Railway deployment from a service's already connected repository or image source, optionally at a repository commit SHA, and return the deployment ID. This action cannot access or upload local
  • Disconnect Discord accountDisconnects the authenticated user's Railway account from Discord. Use when you need to unlink a Discord account that was previously connected to Railway for notifications, authentication, or team man
  • Redeploy DeploymentCreate a new Railway deployment with the selected deployment's exact code and build/deploy configuration, optionally using its previous image tag. This does not deploy the latest source commit and req
  • Rename EnvironmentRename one environment without changing or deploying its configuration.
  • Replace VariablesReplace the entire Railway shared-environment or service variable collection with the supplied complete map. This is irreversible: every existing variable whose key is omitted from the map is permanen
  • Restart DeploymentRestart a running or crashed Railway deployment by reusing its existing image without rebuilding or creating a deployment from newer source. Requires confirm=true.
  • Retry Domain CertificateRead the corrected Railway domainStatus object, then retry custom-domain certificate issuance only when Railway reports certificateRetryable=true. A non-retryable result fails without mutation and inc
  • Rollback DeploymentRestore a previous Railway deployment's Docker image and custom variables as the active deployment without rebuilding. Railway must report canRollback=true; the operation requires confirm=true.
  • Stop DeploymentStop a currently running Railway deployment without deleting the service or its deployment-history record. Requires confirm=true.
  • Update DomainUpdate the hostname or target port of one generated Railway domain, or update the target port of one custom domain.
  • Update ProjectUpdate project settings and configuration on Railway. Use this action when you need to modify project properties such as description, visibility settings, or PR deploy preferences. The following field
  • Update ServiceUpdate a service's name or icon without changing environment-specific deployment settings.
  • Update Service InstanceUpdate build/deploy settings for a service in a specific environment on Railway. Use this action when you need to modify service configuration including commands, healthcheck, replicas, region, and cr
  • Update VolumeRename a Railway volume without changing any volume instance.
  • Update Volume InstanceUpdate a Railway volume's environment-specific mount path, attached service, or state. service_id is required on every call as the current or target attachment; set it to null only to explicitly keep
  • Upsert VariablesCreate or update a non-empty map of Railway shared-environment or service variables without deleting variables omitted from the submitted map. Railway skips deployments by default. Set skip_deploys=fa

Changes wait in Needs you

Changes and sends in Railway are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

How approvals work

Railway questions

Can an agent change data in Railway on its own?

Not by default. Changes and sends in Railway are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

What can an agent read in Railway?

This connector lists 26 read actions. Reads run at once, without waiting for approval.

How does Railway connect?

It connects with API key or OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.

Bring Railway to your agents.