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