Railway MCP Server

Instructions

Implementation Reference

• src/tools/template.tool.ts:70-88 (registration)

  Tool registration and definition including name, formatted description, input schema, and handler function that delegates to templatesService.

  createTool(
    "template_get_workflow_status",
    formatToolDescription({
      type: 'API',
      description: "Get the status of a workflow",
      bestFor: ["Checking workflow status"],
      notFor: ["Creating new services"],
      relations: {
        nextSteps: ["service_info"],
        related: ["template_list, template_deploy"]
      }
    }),
    {
      workflowId: z.string().describe("ID of the workflow to get the status of")
    },
    async ({ workflowId }) => {
      return templatesService.getWorkflowStatus(workflowId);
    }
  ),

• src/services/templates.service.ts:104-122 (handler)

  Core implementation of workflow status retrieval: calls client API, handles errors and completion status, formats success/error responses.

  async getWorkflowStatus(workflowId: string) {
    const response = await this.client.templates.getWorkflowStatus(workflowId);
  
    if (response.error) {
      return createErrorResponse(`Error with workflow ${workflowId}: ${response.error}`);
    }
  
    if (response.status.toLowerCase() === 'complete') {
      return createSuccessResponse({
        text: `Workflow ${workflowId} completed successfully`,
        data: response
      });
    }
  
    return createSuccessResponse({
      text: `Workflow ${workflowId} is still running. Status: ${response.status}`,
      data: response
    });
  }

• src/tools/index.ts:16-37 (registration)

  MCP server registration of all tools, including the templateTools array which contains template_get_workflow_status.

  export function registerAllTools(server: McpServer) {
    // Collect all tools
    const allTools = [
      ...databaseTools,
      ...deploymentTools,
      ...domainTools,
      ...projectTools,
      ...serviceTools,
      ...tcpProxyTools,
      ...variableTools,
      ...configTools,
      ...volumeTools,
      ...templateTools,
    ] as Tool[];
  
    // Register each tool with the server
    allTools.forEach((tool) => {
      server.tool(
        ...tool
      );
    });
  }