Railway MCP Server

Instructions

Implementation Reference

• src/tools/variable.tool.ts:97-127 (registration)

  Tool registration via createTool, including description, input schema, and handler function. The tool is exported as part of variableTools array.
  createTool( "variable_bulk_set", formatToolDescription({ type: 'WORKFLOW', description: "Create or update multiple environment variables at once", bestFor: [ "Migrating configuration between services", "Initial service setup", "Bulk configuration updates" ], notFor: [ "Single variable updates (use variable_set)", "Temporary configuration changes" ], relations: { prerequisites: ["service_list"], nextSteps: ["deployment_trigger", "service_restart"], alternatives: ["variable_set"], related: ["variable_list", "service_update"] } }), { projectId: z.string().describe("ID of the project containing the service"), environmentId: z.string().describe("ID of the environment for the variables (usually obtained from service_list)"), variables: z.record(z.string()).describe("Object mapping variable names to values"), serviceId: z.string().optional().describe("Optional: ID of the service for the variables, if omitted updates shared variables)") }, async ({ projectId, environmentId, variables, serviceId }) => { return variableService.bulkUpsertVariables(projectId, environmentId, variables, serviceId); } ),
• src/services/variable.service.ts:74-93 (handler)

  Core handler logic for bulk upserting variables: converts the variables record to an array of upsert inputs and calls the API client.
  async bulkUpsertVariables(projectId: string, environmentId: string, variables: Record<string, string>, serviceId?: string) { try { const inputs = Object.entries(variables).map(([name, value]) => ({ projectId, environmentId, name, value, serviceId })); await this.client.variables.upsertVariables(inputs); const variableType = serviceId ? "service variables" : "shared environment variables"; return createSuccessResponse({ text: `Successfully updated ${inputs.length} ${variableType}` }); } catch (error) { return createErrorResponse(`Error updating variables: ${formatError(error)}`); } }
• src/tools/variable.tool.ts:118-123 (schema)

  Zod input schema defining parameters for the variable_bulk_set tool.
  { projectId: z.string().describe("ID of the project containing the service"), environmentId: z.string().describe("ID of the environment for the variables (usually obtained from service_list)"), variables: z.record(z.string()).describe("Object mapping variable names to values"), serviceId: z.string().optional().describe("Optional: ID of the service for the variables, if omitted updates shared variables)") },
• src/tools/variable.tool.ts:124-126 (helper)

  Thin wrapper handler that delegates to the variableService.bulkUpsertVariables method.
  async ({ projectId, environmentId, variables, serviceId }) => { return variableService.bulkUpsertVariables(projectId, environmentId, variables, serviceId); }
• src/tools/index.ts:32-36 (registration)

  Global registration of all tools (including variableTools containing variable_bulk_set) with the MCP server.
  allTools.forEach((tool) => { server.tool( ...tool ); });