Railway

Manage Railway projects, services, deployments, and variables

使用说明

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

工具

`railway_list_projects`

List Railway projects visible to the provided token

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`workspaceId`	string	否	Workspace ID to list projects from
`first`	number	否	Maximum number of projects to return
`after`	string	否	Cursor for pagination

输出

参数	类型	描述
`projects`	array	Railway projects
↳ `id`	string	Project ID
↳ `name`	string	Project name
↳ `description`	string	Project description
↳ `createdAt`	string	Project creation timestamp
↳ `updatedAt`	string	Project update timestamp
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether more projects are available
↳ `endCursor`	string	Cursor for the next page
`count`	number	Number of projects returned

`railway_get_project`

Get a Railway project with its services and environments

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	是	Railway project ID

输出

参数	类型	描述
`project`	object	Project with services and environments
↳ `id`	string	Project ID
↳ `name`	string	Project name
↳ `description`	string	Project description
↳ `createdAt`	string	Project creation timestamp
↳ `updatedAt`	string	Project update timestamp
↳ `services`	array	Project services
↳ `id`	string	Service ID
↳ `name`	string	Service name
↳ `icon`	string	Service icon
↳ `environments`	array	Project environments
↳ `id`	string	Environment ID
↳ `name`	string	Environment name

`railway_create_project`

Create a Railway project

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`name`	string	是	Project name
`description`	string	否	Project description
`workspaceId`	string	否	Workspace ID to create the project in
`isPublic`	boolean	否	Whether the project should be publicly visible
`defaultEnvironmentName`	string	否	Name for the default environment
`prDeploys`	boolean	否	Whether to enable pull request deploys

输出

参数	类型	描述
`project`	object	Created project
↳ `id`	string	Project ID
↳ `name`	string	Project name

`railway_update_project`

Update a Railway project name or description

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	是	Railway project ID
`name`	string	否	Updated project name
`description`	string	否	Updated project description
`isPublic`	boolean	否	Whether the project should be publicly visible
`prDeploys`	boolean	否	Whether to enable pull request deploy environments

输出

参数	类型	描述
`project`	object	Updated project
↳ `id`	string	Project ID
↳ `name`	string	Project name
↳ `description`	string	Project description

`railway_delete_project`

Delete a Railway project

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	是	Railway project ID

输出

参数	类型	描述
`success`	boolean	Whether the project was deleted

`railway_transfer_project`

Transfer a Railway project to another workspace

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	是	Railway project ID
`workspaceId`	string	是	Destination workspace ID

输出

参数	类型	描述
`success`	boolean	Whether the project was transferred

`railway_list_project_members`

List members for a Railway project

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	是	Railway project ID

输出

参数	类型	描述
`members`	array	Project members
↳ `id`	string	Member user ID
↳ `role`	string	Project role
↳ `name`	string	Member name
↳ `email`	string	Member email
↳ `avatar`	string	Member avatar URL
`count`	number	Number of members returned

`railway_create_environment`

Create a Railway project environment

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	是	Railway project ID
`name`	string	是	Environment name
`sourceEnvironmentId`	string	否	Environment ID to clone from
`ephemeral`	boolean	否	Whether the environment is ephemeral
`skipInitialDeploys`	boolean	否	Whether to skip initial deploys for the environment
`stageInitialChanges`	boolean	否	Whether to stage initial changes instead of applying them immediately

输出

参数	类型	描述
`environment`	object	Created environment
↳ `id`	string	Environment ID
↳ `name`	string	Environment name

`railway_delete_environment`

Delete a Railway project environment

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`environmentId`	string	是	Railway environment ID

输出

参数	类型	描述
`success`	boolean	Whether the environment was deleted

`railway_create_service`

Create a Railway service from a GitHub repo or Docker image

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	是	Railway project ID
`name`	string	是	Service name
`repo`	string	否	GitHub repository in owner/name format to deploy from
`image`	string	否	Docker image to deploy, for example redis:7-alpine
`branch`	string	否	Git branch to deploy when using a repository source

输出

参数	类型	描述
`service`	object	Created service
↳ `id`	string	Service ID
↳ `name`	string	Service name

`railway_delete_service`

Delete a Railway service and all of its deployments

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`serviceId`	string	是	Railway service ID

输出

参数	类型	描述
`success`	boolean	Whether the service was deleted

`railway_list_deployments`

List deployments for a Railway service in an environment

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	是	Railway project ID
`serviceId`	string	是	Railway service ID
`environmentId`	string	是	Railway environment ID
`first`	number	否	Maximum number of deployments to return
`after`	string	否	Cursor for pagination

输出

参数	类型	描述
`deployments`	array	Service deployments
↳ `id`	string	Deployment ID
↳ `status`	string	Deployment status
↳ `createdAt`	string	Deployment creation timestamp
↳ `url`	string	Deployment URL
↳ `staticUrl`	string	Static deployment URL
↳ `canRollback`	boolean	Whether this deployment can be rolled back to
↳ `canRedeploy`	boolean	Whether this deployment can be redeployed
`count`	number	Number of deployments returned
`pageInfo`	object	Pagination information
↳ `hasNextPage`	boolean	Whether more deployments are available
↳ `endCursor`	string	Cursor for the next page

`railway_get_deployment`

Get details for a single Railway deployment

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`deploymentId`	string	是	Railway deployment ID

输出

参数	类型	描述
`deployment`	object	Deployment details
↳ `id`	string	Deployment ID
↳ `status`	string	Deployment status
↳ `createdAt`	string	Deployment creation timestamp
↳ `url`	string	Deployment URL
↳ `staticUrl`	string	Static deployment URL
↳ `canRollback`	boolean	Whether the deployment can be rolled back to
↳ `canRedeploy`	boolean	Whether the deployment can be redeployed

`railway_deploy_service`

Trigger a deployment for a Railway service in an environment

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`serviceId`	string	是	Railway service ID
`environmentId`	string	是	Railway environment ID
`commitSha`	string	否	Specific Git commit SHA to deploy

输出

参数	类型	描述
`deploymentId`	string	Created deployment ID

`railway_restart_deployment`

Restart a running Railway deployment without rebuilding

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`deploymentId`	string	是	Railway deployment ID

输出

参数	类型	描述
`success`	boolean	Whether the deployment was restarted

`railway_rollback_deployment`

Roll a Railway service back to a previous deployment

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`deploymentId`	string	是	Railway deployment ID to roll back to (must have canRollback)

输出

参数	类型	描述
`success`	boolean	Whether the rollback was triggered

`railway_get_deployment_logs`

Retrieve runtime logs for a Railway deployment

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`deploymentId`	string	是	Railway deployment ID
`limit`	number	否	Maximum number of log lines to return

输出

参数	类型	描述
`logs`	array	Deployment log entries
↳ `timestamp`	string	Log timestamp
↳ `message`	string	Log message
↳ `severity`	string	Log severity
`count`	number	Number of log entries returned

`railway_list_variables`

List Railway environment variables for a service or shared environment

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	是	Railway project ID
`environmentId`	string	是	Railway environment ID
`serviceId`	string	否	Railway service ID. Omit for shared environment variables.

输出

参数	类型	描述
`variables`	object	Variable names and values
`count`	number	Number of variables returned

`railway_upsert_variable`

Create or update a Railway environment variable

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	是	Railway project ID
`environmentId`	string	是	Railway environment ID
`serviceId`	string	否	Railway service ID. Omit to create or update a shared variable.
`name`	string	是	Variable name
`value`	string	是	Variable value
`skipDeploys`	boolean	否	Whether to skip automatic redeploys after changing the variable

输出

参数	类型	描述
`success`	boolean	Whether the variable was created or updated

`railway_delete_variable`

Delete a Railway environment variable

输入

参数	类型	必填	描述
`apiKey`	string	是	Railway API token
`tokenType`	string	否	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	是	Railway project ID
`environmentId`	string	是	Railway environment ID
`name`	string	是	Variable name to delete
`serviceId`	string	否	Railway service ID. Omit to delete a shared variable.

输出

参数	类型	描述
`success`	boolean	Whether the variable was deleted