Railway MCP Server

Instructions

Implementation Reference

• src/tools/project.tool.ts:82-107 (registration)

  Tool registration for 'project_delete', including schema (projectId: string) and thin handler delegating to projectService

  createTool(
    "project_delete",
    formatToolDescription({
      type: 'API',
      description: "Delete a Railway project and all its resources",
      bestFor: [
        "Removing unused projects",
        "Cleaning up test projects",
      ],
      notFor: [
        "Temporary project deactivation",
        "Service-level cleanup (use service_delete)"
      ],
      relations: {
        prerequisites: ["project_list", "project_info"],
        alternatives: ["service_delete"],
        related: ["project_create"]
      }
    }),
    {
      projectId: z.string().describe("ID of the project to delete")
    },
    async ({ projectId }) => {
      return projectService.deleteProject(projectId);
    }
  ),

• src/services/project.service.ts:96-105 (handler)

  Core handler for project deletion in ProjectService, executes API call and formats response

  async deleteProject(projectId: string): Promise<CallToolResult> {
    try {
      await this.client.projects.deleteProject(projectId);
      return createSuccessResponse({
        text: "Project deleted successfully"
      });
    } catch (error) {
      return createErrorResponse(`Error deleting project: ${formatError(error)}`);
    }
  }

• src/api/repository/project.repo.ts:175-181 (helper)

  Repository helper executing GraphQL mutation to delete project via Railway API

  async deleteProject(projectId: string): Promise<void> {
    await this.client.request<{ projectDelete: boolean }>(`
      mutation projectDelete($projectId: String!) {
        projectDelete(id: $projectId)
      }
    `, { projectId });
  }