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
    );
  });