variable_bulk_set
Create or update multiple environment variables simultaneously for Railway.app services. Use this tool to migrate configurations, set up new services, or apply bulk updates efficiently.
Instructions
[WORKFLOW] Create or update multiple environment variables at once
⚡️ Best for: ✓ Migrating configuration between services ✓ Initial service setup ✓ Bulk configuration updates
⚠️ Not for: × Single variable updates (use variable_set) × Temporary configuration changes
→ Prerequisites: service_list
→ Alternatives: variable_set
→ Next steps: deployment_trigger, service_restart
→ Related: variable_list, service_update
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | Yes | ID of the project containing the service | |
| environmentId | Yes | ID of the environment for the variables (usually obtained from service_list) | |
| variables | Yes | Object mapping variable names to values | |
| serviceId | No | Optional: ID of the service for the variables, if omitted updates shared variables) |
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 ); });