Railway

Manage Railway projects, services, deployments, and variables

Instructions d'utilisation

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

Outils

`railway_list_projects`

List Railway projects visible to the provided token

Entrée

Paramètre	Type	Obligatoire	Description
`apiKey`	string	Oui	Railway API token
`tokenType`	string	Non	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`workspaceId`	string	Non	Workspace ID to list projects from
`first`	number	Non	Maximum number of projects to return
`after`	string	Non	Cursor for pagination

Sortie

Paramètre	Type	Description
`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

Entrée

Paramètre	Type	Obligatoire	Description
`apiKey`	string	Oui	Railway API token
`tokenType`	string	Non	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Oui	Railway project ID

Sortie

Paramètre	Type	Description
`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

Entrée

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

Sortie

Paramètre	Type	Description
`project`	object	Created project
↳ `id`	string	Project ID
↳ `name`	string	Project name

`railway_update_project`

Update a Railway project name or description

Entrée

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

Sortie

Paramètre	Type	Description
`project`	object	Updated project
↳ `id`	string	Project ID
↳ `name`	string	Project name
↳ `description`	string	Project description

`railway_delete_project`

Delete a Railway project

Entrée

Paramètre	Type	Obligatoire	Description
`apiKey`	string	Oui	Railway API token
`tokenType`	string	Non	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Oui	Railway project ID

Sortie

Paramètre	Type	Description
`success`	boolean	Whether the project was deleted

`railway_transfer_project`

Transfer a Railway project to another workspace

Entrée

Paramètre	Type	Obligatoire	Description
`apiKey`	string	Oui	Railway API token
`tokenType`	string	Non	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Oui	Railway project ID
`workspaceId`	string	Oui	Destination workspace ID

Sortie

Paramètre	Type	Description
`success`	boolean	Whether the project was transferred

`railway_list_project_members`

List members for a Railway project

Entrée

Paramètre	Type	Obligatoire	Description
`apiKey`	string	Oui	Railway API token
`tokenType`	string	Non	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Oui	Railway project ID

Sortie

Paramètre	Type	Description
`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

Entrée

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

Sortie

Paramètre	Type	Description
`environment`	object	Created environment
↳ `id`	string	Environment ID
↳ `name`	string	Environment name

`railway_delete_environment`

Delete a Railway project environment

Entrée

Paramètre	Type	Obligatoire	Description
`apiKey`	string	Oui	Railway API token
`tokenType`	string	Non	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`environmentId`	string	Oui	Railway environment ID

Sortie

Paramètre	Type	Description
`success`	boolean	Whether the environment was deleted

`railway_create_service`

Create a Railway service from a GitHub repo or Docker image

Entrée

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

Sortie

Paramètre	Type	Description
`service`	object	Created service
↳ `id`	string	Service ID
↳ `name`	string	Service name

`railway_delete_service`

Delete a Railway service and all of its deployments

Entrée

Paramètre	Type	Obligatoire	Description
`apiKey`	string	Oui	Railway API token
`tokenType`	string	Non	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`serviceId`	string	Oui	Railway service ID

Sortie

Paramètre	Type	Description
`success`	boolean	Whether the service was deleted

`railway_list_deployments`

List deployments for a Railway service in an environment

Entrée

Paramètre	Type	Obligatoire	Description
`apiKey`	string	Oui	Railway API token
`tokenType`	string	Non	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Oui	Railway project ID
`serviceId`	string	Oui	Railway service ID
`environmentId`	string	Oui	Railway environment ID
`first`	number	Non	Maximum number of deployments to return
`after`	string	Non	Cursor for pagination

Sortie

Paramètre	Type	Description
`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

Entrée

Paramètre	Type	Obligatoire	Description
`apiKey`	string	Oui	Railway API token
`tokenType`	string	Non	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`deploymentId`	string	Oui	Railway deployment ID

Sortie

Paramètre	Type	Description
`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

Entrée

Paramètre	Type	Obligatoire	Description
`apiKey`	string	Oui	Railway API token
`tokenType`	string	Non	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`serviceId`	string	Oui	Railway service ID
`environmentId`	string	Oui	Railway environment ID
`commitSha`	string	Non	Specific Git commit SHA to deploy

Sortie

Paramètre	Type	Description
`deploymentId`	string	Created deployment ID

`railway_restart_deployment`

Restart a running Railway deployment without rebuilding

Entrée

Paramètre	Type	Obligatoire	Description
`apiKey`	string	Oui	Railway API token
`tokenType`	string	Non	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`deploymentId`	string	Oui	Railway deployment ID

Sortie

Paramètre	Type	Description
`success`	boolean	Whether the deployment was restarted

`railway_rollback_deployment`

Roll a Railway service back to a previous deployment

Entrée

Paramètre	Type	Obligatoire	Description
`apiKey`	string	Oui	Railway API token
`tokenType`	string	Non	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`deploymentId`	string	Oui	Railway deployment ID to roll back to (must have canRollback)

Sortie

Paramètre	Type	Description
`success`	boolean	Whether the rollback was triggered

`railway_get_deployment_logs`

Retrieve runtime logs for a Railway deployment

Entrée

Paramètre	Type	Obligatoire	Description
`apiKey`	string	Oui	Railway API token
`tokenType`	string	Non	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`deploymentId`	string	Oui	Railway deployment ID
`limit`	number	Non	Maximum number of log lines to return

Sortie

Paramètre	Type	Description
`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

Entrée

Paramètre	Type	Obligatoire	Description
`apiKey`	string	Oui	Railway API token
`tokenType`	string	Non	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Oui	Railway project ID
`environmentId`	string	Oui	Railway environment ID
`serviceId`	string	Non	Railway service ID. Omit for shared environment variables.

Sortie

Paramètre	Type	Description
`variables`	object	Variable names and values
`count`	number	Number of variables returned

`railway_upsert_variable`

Create or update a Railway environment variable

Entrée

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

Sortie

Paramètre	Type	Description
`success`	boolean	Whether the variable was created or updated

`railway_delete_variable`

Delete a Railway environment variable

Entrée

Paramètre	Type	Obligatoire	Description
`apiKey`	string	Oui	Railway API token
`tokenType`	string	Non	Railway token type. Use "account" for account, workspace, or OAuth tokens, or "project" for project tokens.
`projectId`	string	Oui	Railway project ID
`environmentId`	string	Oui	Railway environment ID
`name`	string	Oui	Variable name to delete
`serviceId`	string	Non	Railway service ID. Omit to delete a shared variable.

Sortie

Paramètre	Type	Description
`success`	boolean	Whether the variable was deleted