mcp-turso-cloud

Instructions

Implementation Reference

• src/clients/organization.ts:121-150 (handler)

  The core handler function that performs the actual DELETE API request to the Turso platform to delete the specified database.

  export async function delete_database(name: string): Promise<void> {
  	const organization_id = get_organization_id();
  	const url = `${API_BASE_URL}/organizations/${organization_id}/databases/${name}`;
  
  	try {
  		const response = await fetch(url, {
  			method: 'DELETE',
  			headers: get_auth_header(),
  		});
  
  		if (!response.ok) {
  			const errorData = await response.json().catch(() => ({}));
  			const errorMessage = errorData.error || response.statusText;
  			throw new TursoApiError(
  				`Failed to delete database ${name}: ${errorMessage}`,
  				response.status,
  			);
  		}
  	} catch (error) {
  		if (error instanceof TursoApiError) {
  			throw error;
  		}
  		throw new TursoApiError(
  			`Failed to delete database ${name}: ${
  				(error as Error).message
  			}`,
  			500,
  		);
  	}
  }

• src/tools/handler.ts:140-157 (registration)

  Registers the 'delete_database' tool with the MCP server using server.tool(), providing name, description, input schema, and a thin wrapper handler that calls the organization client implementation.

  server.tool(
  	{
  		name: 'delete_database',
  		description: `⚠️ DESTRUCTIVE: Permanently deletes a database and ALL its data. Cannot be undone. Always confirm with user before proceeding and verify correct database name.`,
  		schema: DeleteDatabaseSchema,
  	},
  	async ({ name }) => {
  		try {
  			await organization_client.delete_database(name);
  			return create_tool_response({
  				success: true,
  				message: `Database '${name}' deleted successfully`,
  			});
  		} catch (error) {
  			return create_tool_error_response(error);
  		}
  	},
  );

• src/tools/handler.ts:23-25 (schema)

  Zod schema definition for the delete_database tool input, validating the 'name' parameter with description.

  const DeleteDatabaseSchema = z.object({
  	name: z.string().describe('Name of the database to permanently delete - WARNING: ALL DATA WILL BE LOST FOREVER'),
  });