Tools

Railway

Manage Railway projects, services, deployments, and variables

Usage Instructions

Integrate Railway into workflows to list projects, manage services and environments, monitor deployments, trigger and roll back service deployments, and manage environment variables.

Tools

`railway_list_projects`

List Railway projects visible to the provided token

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`workspaceId`	string	No	Workspace ID to list projects from
`first`	number	No	Maximum number of projects to return
`after`	string	No	Cursor for pagination

Output

Parameter	Type	Description
`projects`	array	Railway projects
`pageInfo`	object	Pagination information
`count`	number	Number of projects returned

`railway_get_project`

Get a Railway project with its services and environments

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Yes	Railway project ID

Output

Parameter	Type	Description
`project`	object	Project with services and environments

`railway_create_project`

Create a Railway project

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`name`	string	Yes	Project name
`description`	string	No	Project description
`workspaceId`	string	No	Workspace ID to create the project in
`isPublic`	boolean	No	Whether the project should be publicly visible
`defaultEnvironmentName`	string	No	Name for the default environment
`prDeploys`	boolean	No	Whether to enable pull request deploys

Output

Parameter	Type	Description
`project`	object	Created project

`railway_update_project`

Update a Railway project name or description

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Yes	Railway project ID
`name`	string	No	Updated project name
`description`	string	No	Updated project description
`isPublic`	boolean	No	Whether the project should be publicly visible
`prDeploys`	boolean	No	Whether to enable pull request deploy environments

Output

Parameter	Type	Description
`project`	object	Updated project

`railway_delete_project`

Delete a Railway project

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Yes	Railway project ID

Output

Parameter	Type	Description
`success`	boolean	Whether the project was deleted

`railway_transfer_project`

Transfer a Railway project to another workspace

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Yes	Railway project ID
`workspaceId`	string	Yes	Destination workspace ID

Output

Parameter	Type	Description
`success`	boolean	Whether the project was transferred

`railway_list_project_members`

List members for a Railway project

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Yes	Railway project ID

Output

Parameter	Type	Description
`members`	array	Project members
`count`	number	Number of members returned

`railway_create_environment`

Create a Railway project environment

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Yes	Railway project ID
`name`	string	Yes	Environment name
`sourceEnvironmentId`	string	No	Environment ID to clone from
`ephemeral`	boolean	No	Whether the environment is ephemeral
`skipInitialDeploys`	boolean	No	Whether to skip initial deploys for the environment
`stageInitialChanges`	boolean	No	Whether to stage initial changes instead of applying them immediately

Output

Parameter	Type	Description
`environment`	object	Created environment

`railway_delete_environment`

Delete a Railway project environment

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`environmentId`	string	Yes	Railway environment ID

Output

Parameter	Type	Description
`success`	boolean	Whether the environment was deleted

`railway_create_service`

Create a Railway service from a GitHub repo or Docker image

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Yes	Railway project ID
`name`	string	Yes	Service name
`repo`	string	No	GitHub repository in owner/name format to deploy from
`image`	string	No	Docker image to deploy, for example redis:7-alpine
`branch`	string	No	Git branch to deploy when using a repository source

Output

Parameter	Type	Description
`service`	object	Created service

`railway_delete_service`

Delete a Railway service and all of its deployments

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`serviceId`	string	Yes	Railway service ID

Output

Parameter	Type	Description
`success`	boolean	Whether the service was deleted

`railway_list_deployments`

List deployments for a Railway service in an environment

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Yes	Railway project ID
`serviceId`	string	Yes	Railway service ID
`environmentId`	string	Yes	Railway environment ID
`first`	number	No	Maximum number of deployments to return
`after`	string	No	Cursor for pagination

Output

Parameter	Type	Description
`deployments`	array	Service deployments
`count`	number	Number of deployments returned
`pageInfo`	object	Pagination information

`railway_get_deployment`

Get details for a single Railway deployment

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`deploymentId`	string	Yes	Railway deployment ID

Output

Parameter	Type	Description
`deployment`	object	Deployment details

`railway_deploy_service`

Trigger a deployment for a Railway service in an environment

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`serviceId`	string	Yes	Railway service ID
`environmentId`	string	Yes	Railway environment ID
`commitSha`	string	No	Specific Git commit SHA to deploy

Output

Parameter	Type	Description
`deploymentId`	string	Created deployment ID

`railway_restart_deployment`

Restart a running Railway deployment without rebuilding

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`deploymentId`	string	Yes	Railway deployment ID

Output

Parameter	Type	Description
`success`	boolean	Whether the deployment was restarted

`railway_rollback_deployment`

Roll a Railway service back to a previous deployment

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`deploymentId`	string	Yes	Railway deployment ID to roll back to (must have canRollback)

Output

Parameter	Type	Description
`success`	boolean	Whether the rollback was triggered

`railway_get_deployment_logs`

Retrieve runtime logs for a Railway deployment

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`deploymentId`	string	Yes	Railway deployment ID
`limit`	number	No	Maximum number of log lines to return

Output

Parameter	Type	Description
`logs`	array	Deployment log entries
`count`	number	Number of log entries returned

`railway_list_variables`

List Railway environment variables for a service or shared environment

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Yes	Railway project ID
`environmentId`	string	Yes	Railway environment ID
`serviceId`	string	No	Railway service ID. Omit for shared environment variables.

Output

Parameter	Type	Description
`variables`	object	Variable names and values
`count`	number	Number of variables returned

`railway_upsert_variable`

Create or update a Railway environment variable

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Yes	Railway project ID
`environmentId`	string	Yes	Railway environment ID
`serviceId`	string	No	Railway service ID. Omit to create or update a shared variable.
`name`	string	Yes	Variable name
`value`	string	Yes	Variable value
`skipDeploys`	boolean	No	Whether to skip automatic redeploys after changing the variable

Output

Parameter	Type	Description
`success`	boolean	Whether the variable was created or updated

`railway_delete_variable`

Delete a Railway environment variable

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Railway API token
`tokenType`	string	No	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Yes	Railway project ID
`environmentId`	string	Yes	Railway environment ID
`name`	string	Yes	Variable name to delete
`serviceId`	string	No	Railway service ID. Omit to delete a shared variable.

Output

Parameter	Type	Description
`success`	boolean	Whether the variable was deleted

Notes

Category: tools
Type: railway

Railway