Railway MCP Server

Instructions

Implementation Reference

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

  Defines the MCP tool 'project_delete' with input schema (projectId: string) and handler function that delegates to projectService.deleteProject
  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/tools/index.ts:32-36 (registration)

  Registers the project_delete tool (included in projectTools) with the MCP server via server.tool() call
  allTools.forEach((tool) => { server.tool( ...tool ); });
• src/tools/project.tool.ts:101-103 (schema)

  Zod input schema for project_delete tool requiring projectId
  { projectId: z.string().describe("ID of the project to delete") },
• src/services/project.service.ts:96-105 (helper)

  projectService.deleteProject: formats response and calls repository deleteProject
  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)

  GraphQL mutation execution to delete the project via Railway API
  async deleteProject(projectId: string): Promise<void> { await this.client.request<{ projectDelete: boolean }>(` mutation projectDelete($projectId: String!) { projectDelete(id: $projectId) } `, { projectId }); }